INTF_ENTRY (Windows CE 5.0)
This structure contains detailed information about an interface that is required by an RPC client.
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; BOOL bInitialized;} INTF_ENTRY, *PINTF_ENTRY;
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 NDIS. For more information about this driver, see Automatic 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 is NdisMedium802_3 as defined in Ndispnp.h. For information about media types, see OID_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, see OID_GEN_PHYSICAL_MEDIUM. - nInfraMode
Current 802.11 Infrastructure Mode set on the interface. The possible values are defined in the NDIS_802_11_NETWORK_INFRASTRUCTURE enumeration. - nAuthMode
Current 802.11 Authentication Mode set on the interface. The possible values are defined in the NDIS_802_11_AUTHENTICATION_MODE enumeration. - nWepStatus
Current 802.11 Encryption Mode set on the interface. The possible values are defined in the NDIS_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 & dwCtlFlags result in a value of the type NDIS_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 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 & 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. The pData 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 an OID_802_11_BSSID value. The pData member of rdBSSID - rdBSSIDList
Binary data that contains the list of BSSIDs that was last retrieved by WZCSVC by specifying an OID_802_11_BSSID_LIST value. The pData 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. The pData member of rdStSSIDList points to a WZC_802_11_CONFIG_LIST object. - rdCtrlData
Binary data used in with other control flags, when setting additional parameters to the interface. - pdwOutFlags
Pointer to DWORD that indicates whether or not data was successfully retrieved by WZCSVC. If this member is set to a non-NULL, WZCSVC sets the same bit values as used for dwCtlFlags, which corresponds to the data that was successfully retrieved. If this indication is not needed, then the caller must set this member to NULL. - bInitialized
Boolean value that determines if the caller using this structure has initialized it successfully.
Remarks
The RAW_DATA structure is defined in Wzcapi.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 by pData.
Requirements
OS Versions: Windows CE .NET 4.2 and later.
Header: Wzcsapi.h.
See Also
Automatic Configuration Structures | WZCQueryInterface
Send Feedback on this topic to the authors