WZC_WLAN_CONFIG (Windows CE 5.0)
This structure stores information about the preferred wireless zero configuration.
typedef struct{ ULONG Length; DWORD dwCtlFlags; NDIS_802_11_MAC_ADDRESS MacAddress; UCHAR Reserved[2]; NDIS_802_11_SSID Ssid; ULONG Privacy; NDIS_802_11_RSSI Rssi; NDIS_802_11_NETWORK_TYPE NetworkTypeInUse; NDIS_802_11_CONFIGURATION Configuration; NDIS_802_11_NETWORK_INFRASTRUCTURE InfrastructureMode; NDIS_802_11_RATES SupportedRates; ULONG KeyIndex; ULONG KeyLength; UCHAR KeyMaterial[WZCCTL_MAX_WEPK_MATERIAL]; NDIS_802_11_AUTHENTICATION_MODE AuthenticationMode; RAW_DATA rdUserData; WZC_EAPOL_PARAMS EapolParams; RAW_DATA rdNetworkData; ULONG WPAMCastCipher; ULONG ulMediaType;} WZC_WLAN_CONFIG, *PWZC_WLAN_CONFIG;
Members
- Length
Length of WZC_WLAN_CONFIG. - dwCtlFlags
Control flags for the preferred configuration. The following table shows the possible values.Values Description WZCCTL_MAX_WEPK_MATERIAL Size of the KeyMaterial array in the WZC_WLAN_CONFIG structure. WZCCTL_WEPK_PRESENT (0x0001) Determines whether the configuration includes a WEP key. WZCCTL_WEPK_XFORMAT (0x0002) The WEP Key material, if available, is entered as hexadecimal digits WZCCTL_VOLATILE (0x0004) Indicates that the configuration should not be stored. WZCCTL_POLICY (0x0008) Indicates that the configuration is enforced by the policy. WZCCTL_ONEX_ENABLED (0x0010) Indicates that 802.1X should be enabled for this configuration. - MacAddress
MAC address of the associated access point. For more information, see NDIS_802_11_MAC_ADDRESS. - Ssid
NIC service set identifier (SSID) value. For more information see, NDIS_802_11_SSID. - Privacy
Wireless Equivalent Privacy (WEP) implementation status for a particular 802.11 NIC. The possible values are defined in the NDIS_802_11_WEP_STATUS enumeration. - Rssi
Received signal strength indication (RSSI) in dB-milliwatts (dBm). For more information, see NDIS_802_11_RSSI. - NetworkTypeInUse
Network subtype values for the physical layer of used with a specific driver. The possible values are defined in the NDIS_802_11_NETWORK_TYPE enumeration. - Configuration
Configuration of the radio. For more information, see NDIS_802_11_CONFIGURATION. - SupportedRates
Data rates. For more information, see NDIS_802_11_RATES. - KeyIndex
802.11 WEP key index. The global keys are represented by values of 1 to n. Zero represents a per-client key. For more information about the key types, see OID_802_11_ADD_WEP. - KeyLength
Specifies the length of KeyMaterial character array in bytes. - KeyMaterial
Variable length depending on KeyLength. Set to the values defined in Pre-allocated to WZCCTL_MAX_WEPK_MATERIAL. - AuthenticationMode
802.11 authentication mode value. For more information about the possible authentication values, see NDIS_802_11_AUTHENTICATION_MODE. - rdUserData
Not used. - EapolParams
Contains information about 802.1x authentication. For more information, see WZC_EAPOL_PARAMS. - rdNetworkData
Not used. - WPAMCastCipher
Multicast Cipher Suite for WPA. The possible values are defined in NDIS_802_11_WEP_STATUS. The applications need not set this member. - 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.
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 | WZCPassword2Key
Send Feedback on this topic to the authors