INTF_ENTRY_EX結構體詳解__微軟

INTF_ENTRY_EX

Windows Embedded CE 6.0 R3

1/6/2010

This extended structure contains detailed information about an interface that is required by a remote procedure call (RPC) client.

It also includes information about the multicast cipher suite, Wireless Network Interface Card (WNIC) capabilities, and the pairwise master key (PMK) cache.

Syntax

---

typedef struct
{
    LPWSTR          wszGuid;
    LPWSTR          wszDescr;
    ULONG           ulMediaState;
    ULONG           ulMediaType;
    ULONG           ulPhysicalMediaType;
    INT             nInfraMode;
    INT             nAuthMode;
    INT             nWepStatus;
    DWORD           dwCtlFlags;
    DWORD           dwCapabilities;
    RAW_DATA        rdSSID;
    RAW_DATA        rdBSSID;
    RAW_DATA        rdBSSIDList;
    RAW_DATA        rdStSSIDList;
    RAW_DATA        rdCtrlData;
    BOOL            bInitialized;
    DWORD           nWPAMCastCipher;
    ULONG           ulVersion;
    RAW_DATA        rdNicCapabilities;
    RAW_DATA        rdPMKCache;
    ULONG           PMKCacheFlags;
} INTF_ENTRY_EX, *PINTF_ENTRY_EX;

Members

---

wszGuid

Pointer to the interface GUID represented as a Unicode string in the following format: "{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}".

wszDescr

Pointer to a string that contains the interface description that is retrieved by the Wireless Automatic Configuration driver (WZCSVC) from Network Driver Interface Specification (NDIS). For more information about this driver, seeAutomatic Configuration Subsystem.

ulMediaState

Current NDIS media-connect state for the interface. The following table shows the possible values that are defined in Ndispnp.h.

Media state	Value
MEDIA_STATE_CONNECTED	1
MEDIA_STATE_DISCONNECTED	0
MEDIA_STATE_UNKNOWN	-1

ulMediaType

NDIS media types that the NIC currently uses. When queried, the value of this member isNdisMedium802_3 as defined in Ndispnp.h. For information about media types, seeOID_GEN_MEDIA_IN_USE.

ulPhysicalMediaType

NDIS media type for the interface. When queried, the value of this member is NdisPhysicalMediumWirelessLan as defined in Ndispnp.h. For more information about physical-media types, seeOID_GEN_PHYSICAL_MEDIUM.

nInfraMode

Current 802.11 Infrastructure mode set on the interface. The possible values are defined in theNDIS_802_11_NETWORK_INFRASTRUCTURE enumeration.

nAuthMode

Current 802.11 Authentication mode set on the interface. The possible values are defined in theNDIS_802_11_AUTHENTICATION_MODE enumeration.

nWepStatus

Current 802.11 Encryption mode set on the interface. The possible values are defined in theNDIS_802_11_WEP_STATUS enumeration.

dwCtlFlags

Bitmask value that indicates how WZCSVC is operating on the interface. The following table shows the possible bit values.

Value	Description
INTFCTL_CM_MASK (0x0007)	Bitmask for the network-filter mode. INTFCTL_CM_MASK and dwCtlFlags result in a value of the typeNDIS_802_11_NETWORK_INFRASTRUCTURE. The resulting value indicates whether WZCSVC connects only to infrastructure networks, adhoc networks, or to both types of networks.
INTFCTL_ENABLED (0x8000)	Indicates whether or not WZCSVC should configure the interface.
INTFCTL_FALLBACK (0x4000)	If a preferred network is not available, this value indicates whether WZCSVC should automatically configure the NIC to associate it to any available network.
INTFCTL_OIDSSUPP (0x2000)	Indicates whether or not the NIC driver supports all the OIDs required by WZCSVC to function.
INTFCTL_VOLATILE (0x1000)	Indicates whether or not the control flags for this interface should not be retained in the registry.
INTFCTL_POLICY (0x0800)	Indicates whether or not the control flags for this interface are pushed by a group policy.
INTFCTL_8021XSUPP (0x1000)	Indicates whether or not 802.1x support is enabled.

dwCapabilities

Specifies the driver capabilities. The following table shows the possible values.

Value	Description
INTFCAP_MAX_CIPHER_MASK (0x000000ff)	Bitmask value for the maximum supported cipher. INTFCAP_MAX_CIPHER_MASK and dwCapabilities result in a value of the type NDIS_802_11_WEP_STATUS
INTFCAP_SSN (0x00000100)	Indicates whether or not the NIC driver supports Wireless Protected Access.

rdSSID

Binary data containing the 802.11 SSID currently configured on the interface. ThepData member of rdSSID points to an NDIS_802_11_SSID object.

rdBSSID

Binary data containing the 802.11 BSSID configured on the interface specified by anOID_802_11_BSSID value. ThepData member of rdBSSID points to a variable of typeNDIS_802_11_MAC_ADDRESS.

rdBSSIDList

Binary data that contains the list of BSSIDs that was last retrieved by WZCSVC by specifying anOID_802_11_BSSID_LIST value. ThepData member of rdBSSIDList points to an NDIS_802_11_BSSID_LIST object.

rdStSSIDList

Binary data that contains the list of preferred networks configured for this interface. ThepData member of rdStSSIDList points to a WZC_802_11_CONFIG_LIST object.

rdCtrlData

Binary data used with other control flags, when setting additional parameters to the interface.

bInitialized

Boolean value that determines if the caller using this structure has initialized it successfully.

nWPAMCastCipher

DWORD that sets the multicast cipher suite. The possible values are defined inNDIS_802_11_WEP_STATUS.

ulVersion

Specifies the version number.

rdNicCapabilities

Points to an INTF_80211_CAPABILITY structure that indicates the capabilities of the NIC.

rdPMKCache

Points to an NDIS_802_11_PMKID structure for the Wi-Fi driver that indicates the set of pairwise master key (PMK) IDs that should be set to the miniport adapter. For more information, seeWPA2 Pre-Authentication.

PMKCacheFlags

Specifies the pairwise master key (PMK) cache flags.

The following table shows the possible values:

Flag	Value	Description
INTF_ENTRY_PMKCACHE_FLAG_ENABLE	(1<<0)	This value determines the enable/disable status of PMK caching.
INTF_ENTRY_PMKCACHE_FLAG_ENABLE_OPPORTUNISTIC	(1<<1)	This value determines the enable/disable status of the opportunistic PMK cache algorithm.
INTF_ENTRY_PMKCACHE_FLAG_ENABLE_PREAUTH	(1<<2)	This value determines the enable/disable status of pre-authentication.
INTF_ENTRY_PMKCACHE_FLAG_FLUSH	(1<<31)	This value is set-only, and it causes a PMK cache flush.

For more information, see WPA2 Pre-Authentication.

Remarks

---

The RAW_DATA structure is defined in Wzcsapi.h, as follows:

typedef struct
{
    DWORD   dwDataLen;
    LPBYTE  pData;
} RAW_DATA, *PRAW_DATA;

The pData member points to binary data. The dwDataLen indicates the number of bytes pointed bypData.

Requirements

---

Header	wzcsapi.h
Windows Embedded CE	Windows Embedded CE 6.0 and later