Share via


WZC_WLAN_CONFIG (Windows Embedded CE 6.0)

1/6/2010

This structure stores information about the preferred wireless zero configuration.

Syntax

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.

  • 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.
  • 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.
  • 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

Header wzcsapi.h
Windows Embedded CE Windows CE .NET 4.2 and later

See Also

Reference

Automatic Configuration Structures
WZCPassword2Key