WZC_WLAN_CONFIG (Windows CE 5.0)

Send Feedback

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

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.