DOT11EXT_VIRTUAL_STATION_AP_PROPERTY structure (wlanihv.h)
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) |