DOT11EXT_VIRTUAL_STATION_AP_PROPERTY structure (wlanihv.h)

The DOT11EXT_VIRTUAL_STATION_AP_PROPERTY structure specifies the properties of an access point (AP) hosted on a virtual 802.11 station.

Syntax

typedef struct _DOT11EXT_VIRTUAL_STATION_AP_PROPERTY {
  DOT11_SSID             dot11SSID;
  DOT11_AUTH_ALGORITHM   dot11AuthAlgo;
  DOT11_CIPHER_ALGORITHM dot11CipherAlgo;
  BOOL                   bIsPassPhrase;
  DWORD                  dwKeyLength;
  UCHAR                  ucKeyData[DOT11EXT_PSK_MAX_LENGTH];
} DOT11EXT_VIRTUAL_STATION_AP_PROPERTY, *PDOT11EXT_VIRTUAL_STATION_AP_PROPERTY;

Members

dot11SSID

A DOT11_SSID structure that contains the service set identifier (SSID) used by the virtual station AP.

dot11AuthAlgo

A DOT11_AUTH_ALGORITHM structure that contains the authentication algorithm used by the virtual station AP.

dot11CipherAlgo

A DOT11_CIPHER_ALGORITHM structure that contains the cipher algorithm used by the virtual station AP.

bIsPassPhrase

A Boolean value that indicates how the operating system should interpret the value of the ucKeyData member. For more information, see the following Remarks section.

dwKeyLength

The length, in bytes, of the useful part of the ucKeyData member. For more information, see the following Remarks section.

ucKeyData[DOT11EXT_PSK_MAX_LENGTH]

A UCHAR value that specifies the key used by the virtual station AP's Preshared Keys (PSK) authentication algorithm. For more information, see the following Remarks section.

Remarks

The operating system uses the following logic to interpret the value of the ucKeyData member:

• If bIsPassPhrase = FALSE,
  • If dwKeyLength = 32, ucKeyData is interpreted as binary data.
  • If dwKeyLength = 64, ucKeyData is interpreted as 32 hexadecimal values.
  • If dwKeyLength is not equal to 32 or 64, the operating system ignores the call and returns an error.
• If bIsPassPhrase = TRUE, ucKeyData is interpreted as a pass phrase, and the buffer must be NULL terminated. In this case, dwKeyLength should have a value that equals 1 plus the length of the key string.

Requirements

Requirement	Value
Minimum supported client	Available in Windows 7 and later versions of the Windows operating systems.
Header	wlanihv.h (include Wlanihv.h)

See also

DOT11_AUTH_ALGORITHM

DOT11_CIPHER_ALGORITHM

DOT11_SSID