WCN_ATTRIBUTE_TYPE enumeration (wcntypes.h)

The WCN_ATTRIBUTE_TYPE enumeration defines the attribute buffer types defined for Wi-Fi Protected Setup. The overall size occupied by each attribute buffer includes an additional 4 bytes (2 bytes of ID, 2 bytes of Length).

Syntax

typedef enum tagWCN_ATTRIBUTE_TYPE {
  WCN_TYPE_AP_CHANNEL,
  WCN_TYPE_ASSOCIATION_STATE,
  WCN_TYPE_AUTHENTICATION_TYPE,
  WCN_TYPE_AUTHENTICATION_TYPE_FLAGS,
  WCN_TYPE_AUTHENTICATOR,
  WCN_TYPE_CONFIG_METHODS,
  WCN_TYPE_CONFIGURATION_ERROR,
  WCN_TYPE_CONFIRMATION_URL4,
  WCN_TYPE_CONFIRMATION_URL6,
  WCN_TYPE_CONNECTION_TYPE,
  WCN_TYPE_CONNECTION_TYPE_FLAGS,
  WCN_TYPE_CREDENTIAL,
  WCN_TYPE_DEVICE_NAME,
  WCN_TYPE_DEVICE_PASSWORD_ID,
  WCN_TYPE_E_HASH1,
  WCN_TYPE_E_HASH2,
  WCN_TYPE_E_SNONCE1,
  WCN_TYPE_E_SNONCE2,
  WCN_TYPE_ENCRYPTED_SETTINGS,
  WCN_TYPE_ENCRYPTION_TYPE,
  WCN_TYPE_ENCRYPTION_TYPE_FLAGS,
  WCN_TYPE_ENROLLEE_NONCE,
  WCN_TYPE_FEATURE_ID,
  WCN_TYPE_IDENTITY,
  WCN_TYPE_IDENTITY_PROOF,
  WCN_TYPE_KEY_WRAP_AUTHENTICATOR,
  WCN_TYPE_KEY_IDENTIFIER,
  WCN_TYPE_MAC_ADDRESS,
  WCN_TYPE_MANUFACTURER,
  WCN_TYPE_MESSAGE_TYPE,
  WCN_TYPE_MODEL_NAME,
  WCN_TYPE_MODEL_NUMBER,
  WCN_TYPE_NETWORK_INDEX,
  WCN_TYPE_NETWORK_KEY,
  WCN_TYPE_NETWORK_KEY_INDEX,
  WCN_TYPE_NEW_DEVICE_NAME,
  WCN_TYPE_NEW_PASSWORD,
  WCN_TYPE_OOB_DEVICE_PASSWORD,
  WCN_TYPE_OS_VERSION,
  WCN_TYPE_POWER_LEVEL,
  WCN_TYPE_PSK_CURRENT,
  WCN_TYPE_PSK_MAX,
  WCN_TYPE_PUBLIC_KEY,
  WCN_TYPE_RADIO_ENABLED,
  WCN_TYPE_REBOOT,
  WCN_TYPE_REGISTRAR_CURRENT,
  WCN_TYPE_REGISTRAR_ESTABLISHED,
  WCN_TYPE_REGISTRAR_LIST,
  WCN_TYPE_REGISTRAR_MAX,
  WCN_TYPE_REGISTRAR_NONCE,
  WCN_TYPE_REQUEST_TYPE,
  WCN_TYPE_RESPONSE_TYPE,
  WCN_TYPE_RF_BANDS,
  WCN_TYPE_R_HASH1,
  WCN_TYPE_R_HASH2,
  WCN_TYPE_R_SNONCE1,
  WCN_TYPE_R_SNONCE2,
  WCN_TYPE_SELECTED_REGISTRAR,
  WCN_TYPE_SERIAL_NUMBER,
  WCN_TYPE_WI_FI_PROTECTED_SETUP_STATE,
  WCN_TYPE_SSID,
  WCN_TYPE_TOTAL_NETWORKS,
  WCN_TYPE_UUID_E,
  WCN_TYPE_UUID_R,
  WCN_TYPE_VENDOR_EXTENSION,
  WCN_TYPE_VERSION,
  WCN_TYPE_X_509_CERTIFICATE_REQUEST,
  WCN_TYPE_X_509_CERTIFICATE,
  WCN_TYPE_EAP_IDENTITY,
  WCN_TYPE_MESSAGE_COUNTER,
  WCN_TYPE_PUBLIC_KEY_HASH,
  WCN_TYPE_REKEY_KEY,
  WCN_TYPE_KEY_LIFETIME,
  WCN_TYPE_PERMITTED_CONFIG_METHODS,
  WCN_TYPE_SELECTED_REGISTRAR_CONFIG_METHODS,
  WCN_TYPE_PRIMARY_DEVICE_TYPE,
  WCN_TYPE_SECONDARY_DEVICE_TYPE_LIST,
  WCN_TYPE_PORTABLE_DEVICE,
  WCN_TYPE_AP_SETUP_LOCKED,
  WCN_TYPE_APPLICATION_EXTENSION,
  WCN_TYPE_EAP_TYPE,
  WCN_TYPE_INITIALIZATION_VECTOR,
  WCN_TYPE_KEY_PROVIDED_AUTOMATICALLY,
  WCN_TYPE_802_1X_ENABLED,
  WCN_TYPE_APPSESSIONKEY,
  WCN_TYPE_WEPTRANSMITKEY,
  WCN_TYPE_UUID,
  WCN_TYPE_PRIMARY_DEVICE_TYPE_CATEGORY,
  WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY_OUI,
  WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY,
  WCN_TYPE_CURRENT_SSID,
  WCN_TYPE_BSSID,
  WCN_TYPE_DOT11_MAC_ADDRESS,
  WCN_TYPE_AUTHORIZED_MACS,
  WCN_TYPE_NETWORK_KEY_SHAREABLE,
  WCN_TYPE_REQUEST_TO_ENROLL,
  WCN_TYPE_REQUESTED_DEVICE_TYPE,
  WCN_TYPE_SETTINGS_DELAY_TIME,
  WCN_TYPE_VERSION2,
  WCN_TYPE_VENDOR_EXTENSION_WFA,
  WCN_NUM_ATTRIBUTE_TYPES
} WCN_ATTRIBUTE_TYPE;

Constants

 
WCN_TYPE_AP_CHANNEL
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method is a value containing data that specifies the 802.11 channel the access point is hosting.
WCN_TYPE_ASSOCIATION_STATE
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method is a value containing the association state or configuration information defined by WCN_VALUE_TYPE_ASSOCIATION_STATE.
WCN_TYPE_AUTHENTICATION_TYPE
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method is a value containing an authentication type defined by WCN_VALUE_TYPE_AUTHENTICATION_TYPE.
WCN_TYPE_AUTHENTICATION_TYPE_FLAGS
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method is a value containing data that specifies the network authentication capabilities of the Enrollee (access point or station) by providing a
value defined by WCN_VALUE_TYPE_AUTHENTICATION_TYPE.
WCN_TYPE_AUTHENTICATOR
This attribute value indicates that the wszString parameter of the IWCNDevice::GetStringAttribute method is a buffer containing a keyed hash of data.

Note  Security is handled transparently by Windows. As a result, applications do not need to query or set this attribute.

 
WCN_TYPE_CONFIG_METHODS
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method contains values, defined by WCN_VALUE_TYPE_CONFIG_METHODS, that specify the configuration methods supported by the Enrollee or Registrar. Additionally, access points and stations
that support the UPnP Management Interface must also support this attribute, which
is used to control the configuration methods that are enabled on the access point.
WCN_TYPE_CONFIGURATION_ERROR
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method is a value, defined by WCN_VALUE_TYPE_CONFIGURATION_ERROR, that specifies the result of the device attempting to configure itself and associate with the WLAN.

If a configuration session fails with the error code WCN_E_CONNECTION_REJECTED, any error code returned by the remote device can be obtained by querying this attribute. It is important to note that some devices will return WCN_VALUE_CE_NO_ERROR even if an error has occurred.
WCN_TYPE_CONFIRMATION_URL4
This attribute value indicates that the wszString parameter of the IWCNDevice::GetStringAttribute method is a buffer that contains data representing the URL (IPv4 address based) provided by the Registrar to the Enrollee for use in posting confirmation
once settings have been successfully applied and the network has been joined. This configuration
parameter is optional for a Registrar, and it is optional for the Enrollee to post to the URL if the Registrar
includes it.

Note  An Enrollee must not connect to a confirmation URL that is on a different subnet.

 
WCN_TYPE_CONFIRMATION_URL6
This attribute value indicates that the wszString parameter of the IWCNDevice::GetStringAttribute method is a buffer that contains data representing the URL (IPv6 address based) provided by the Registrar to the Enrollee for use in posting a confirmation
once settings have been successfully applied and the network has been joined. This configuration
parameter is optional for a Registrar and it is optional for the Enrollee to post to the URL if the Registrar
includes it.

Note  The Enrollee must not connect to a confirmation URL that is on a different subnet.

 
WCN_TYPE_CONNECTION_TYPE
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method contains a value, defined by WCN_VALUE_TYPE_CONNECTION_TYPE, that specifies the connection capability of the Enrollee.
WCN_TYPE_CONNECTION_TYPE_FLAGS
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method contains a value, defined by WCN_VALUE_TYPE_CONNECTION_TYPE, that specifies the connection capability of the Enrollee.
WCN_TYPE_CREDENTIAL
This compound attribute value indicates that the pbBuffer parameter of the IWCNDevice::GetAttribute method contains a single WLAN Credential. There can be either multiple Credential attributes for each Network Key, or multiple
Network Keys in a single Credential attribute, which is accomplished by repeating the Network Key Index and attributes that
follow it. Generally, multiple
keys in a single Credential for a single SSID should be used, and multiple Credential attributes for
separate SSIDs should be used. The following attributes are contained in each instance of Credential:


  • WCN_TYPE_AUTHENTICATION_TYPE

  • WCN_TYPE_ENCRYPTION_TYPE

  • WCN_TYPE_SSID

  • WCN_TYPE_NETWORK_INDEX


If an application intends to use the network credential with the WLAN API, it should use IWCNDevice::GetNetworkProfile to get a compatible XML network profile directly.
WCN_TYPE_DEVICE_NAME
This attribute value indicates that the wszString parameter of the IWCNDevice::GetStringAttribute method is a buffer that contains a user-friendly description of the device encoded in UTF-8. Typically, the component
would be a unique identifier that describes the product in a way that is recognizable to the user.
WCN_TYPE_DEVICE_PASSWORD_ID
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method contains a value, defined by WCN VALUE TYPE DEVICE_PASSWORD_ID, that is used to identify a device password.
WCN_TYPE_E_HASH1
This attribute value indicates that the pbBuffer parameter of the IWCNDevice::GetAttribute method contains the HMAC-SHA-256 hash of the first half of the device password and the Enrollee’s first secret
nonce.

Note  Security is handled transparently by Windows. As a result, applications do not need to query or set this attribute.

 
WCN_TYPE_E_HASH2
This attribute value indicates that the pbBuffer parameter of the IWCNDevice::GetAttribute method contains the HMAC-SHA-256 hash of the second half of the device password, and the Enrollee’s second
secret nonce.

Note  Security is handled transparently by Windows. As a result, applications do not need to query or set this attribute.

 
WCN_TYPE_E_SNONCE1
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method contains the first nonce used by the Enrollee with the first half of the device password.

Note  Security is handled transparently by Windows. As a result, applications do not need to query or set this attribute.

 
WCN_TYPE_E_SNONCE2
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method contains the second nonce used by the Enrollee with the second half of the device password.

Note  Security is handled transparently by Windows. As a result, applications do not need to query or set this attribute.

 
WCN_TYPE_ENCRYPTED_SETTINGS
This attribute value indicates that the pbBuffer parameter of the IWCNDevice::GetAttribute method contains an initialization vector (IV) followed by a set
of encrypted Wi-Fi Protected Setup TLV attributes. The last attribute in the encrypted set is a Key Wrap
Authenticator computed according to the procedure described in section 6.5.

Note  Security is handled transparently by Windows. As a result, applications do not need to query or set this attribute.

 
WCN_TYPE_ENCRYPTION_TYPE
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method contains a value, defined by WCN_VALUE_TYPE_ENCRYPTION_TYPE, for the Enrollee (AP or
station) to use.
WCN_TYPE_ENCRYPTION_TYPE_FLAGS
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method contains a value, defined by WCN_VALUE_TYPE_ENCRYPTION_TYPE, for the Enrollee (AP or
station) to use.
WCN_TYPE_ENROLLEE_NONCE
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method contains a randomly generated binary value that is created by the Enrollee for
setup operations.

Note  Security is handled transparently by Windows. As a result, applications do not need to query or set this attribute.

 
WCN_TYPE_FEATURE_ID
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method contains data that indicates a particular feature build for an operating system running on the device. The most significant bit of the 4 byte integer is reserved, and always set to one.
WCN_TYPE_IDENTITY
Reserved. Do not use.
WCN_TYPE_IDENTITY_PROOF
Reserved. Do not use.
WCN_TYPE_KEY_WRAP_AUTHENTICATOR
This attribute value indicates that the wszString parameter of the IWCNDevice::GetStringAttribute method is a 8 byte buffer containing the first 64 bits of the HMAC-SHA-256 computed over the data to be encrypted
with the key wrap algorithm. It is appended to the end of the ConfigData prior to encryption.

Note  Security is handled transparently by Windows. As a result, applications do not need to query or set this attribute.

 
WCN_TYPE_KEY_IDENTIFIER
This attribute value indicates that the wszString parameter of the IWCNDevice::GetAttribute method is a 16 byte buffer containing a 128-bit key identifier. If this attribute immediately precedes an Encrypted Data
or Authenticator attribute, then the key corresponding to the 128-bit identifier should be used to decrypt
or verify the Data field.
WCN_TYPE_MAC_ADDRESS
This attribute value indicates that the pbBuffer parameter of the IWCNDevice::GetAttribute method is a 6 byte buffer containing the 48 bit value of the MAC Address. For
example: 0x00 0x07 0xE9 0x4C 0xA8 0x1C.

This address is supplied by the remote device. Some Access Points give the MAC address of their Ethernet interface, in which case, the address cannot be used to locate the AP’s wireless radio. If an application needs to locate an AP’s radio, the application should query the WCN_TYPE_BSSID attribute, which is populated by Windows and is generally more reliable.
WCN_TYPE_MANUFACTURER
This attribute value indicates that the pbBuffer parameter of the IWCNDevice::GetAttribute method is a buffer containing a string that identifies the manufacturer of the device.
Generally, this field should allow a user to make an association with a device with the labeling on the
device.
WCN_TYPE_MESSAGE_TYPE
Reserved. Do not use.
WCN_TYPE_MODEL_NAME
This attribute value indicates that the wszString parameter of the IWCNDevice::GetStringAttribute method is a buffer that identifies the model of the device. Generally, this field
should allow a user to create an association of a device with the labeling on the device.
WCN_TYPE_MODEL_NUMBER
This attribute value indicates that the wszString parameter of the IWCNDevice::GetStringAttribute method is a string containing additional descriptive data associated with the device.
WCN_TYPE_NETWORK_INDEX
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method is a 1 byte buffer used to get and set network settings for devices that host more than one network. The
default value is '1' which refers to the primary WLAN network on the device.
WCN_TYPE_NETWORK_KEY
This attribute value indicates that the wszString parameter of the IWCNDevice::GetStringAttribute method is a buffer containing the wireless encryption key to be used by the Enrollee. Note that it is recommended that applications implement IWCNDevice::GetNetworkProfile to get network settings in a convenient format that is ready to be used with the WLAN connection and profile management APIs.
WCN_TYPE_NETWORK_KEY_INDEX
Reserved. Do not use.
WCN_TYPE_NEW_DEVICE_NAME
Reserved. Do not use.
WCN_TYPE_NEW_PASSWORD
Reserved. Do not use.
WCN_TYPE_OOB_DEVICE_PASSWORD
Reserved. Do not use.
WCN_TYPE_OS_VERSION
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method is a 4 byte buffer that contains the operating system version running on the device. The most significant bit of this 4 byte field is reserved, and always set to one.
WCN_TYPE_POWER_LEVEL
Reserved. Do not use.
WCN_TYPE_PSK_CURRENT
Reserved. Do not use.
WCN_TYPE_PSK_MAX
Reserved. Do not use.
WCN_TYPE_PUBLIC_KEY
Reserved. Do not use. We recommend that a shared secret be sent by way of a vendor extension or that you find another way to do cryptography.
WCN_TYPE_RADIO_ENABLED
Reserved. Do not use.
WCN_TYPE_REBOOT
Reserved. Do not use.
WCN_TYPE_REGISTRAR_CURRENT
Reserved. Do not use.
WCN_TYPE_REGISTRAR_ESTABLISHED
Reserved. Do not use.
WCN_TYPE_REGISTRAR_LIST
Reserved. Do not use.
WCN_TYPE_REGISTRAR_MAX
Reserved. Do not use.
WCN_TYPE_REGISTRAR_NONCE
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method is a 16 byte buffer containing a randomly generated binary value created by the Registrar for
setup.

Note  Security is handled transparently by Windows. As a result, applications do not need to query or set this attribute.

 
WCN_TYPE_REQUEST_TYPE
Reserved. Do not use.
WCN_TYPE_RESPONSE_TYPE
Reserved. Do not use.
WCN_TYPE_RF_BANDS
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method is an integer value, defined by WCN_VALUE_TYPE_RF_BANDS, that indicates which RF band is utilized during message exchange, permitting end
points and proxies to communicate over a consistent radio interface. It may also be used as an optional
attribute in a WCN_TYPE_CREDENTIAL or WCN_TYPE_ENCRYPTED_SETTINGS to indicate a specific (or group) of RF bands to which a
setting applies.
WCN_TYPE_R_HASH1
This attribute value indicates that the wszString parameter of the IWCNDevice::GetStringAttribute method is a 32 byte buffer that containing the HMAC-SHA-256 hash of the first half of the device password and the Registrar’s first secret
nonce.

Note  Security is handled transparently by Windows. As a result, applications do not need to query or set this attribute.

 
WCN_TYPE_R_HASH2
This attribute value indicates that the wszString parameter of the IWCNDevice::GetStringAttribute method is a 32 byte buffer containing the HMAC-SHA-256 hash of the second half of the device password and the Registrar’s second
secret nonce.

Note  Security is handled transparently by Windows. As a result, applications do not need to query or set this attribute.

 
WCN_TYPE_R_SNONCE1
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method is a 16 byte buffer containing the first nonce used by the Registrar with the first half of the device password.

Note  Security is handled transparently by Windows. As a result, applications do not need to query or set this attribute.

 
WCN_TYPE_R_SNONCE2
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method is a 16 byte buffer containing the second nonce used by the Registrar with the second half of the device password.

Note  Security is handled transparently by Windows. As a result, applications do not need to query or set this attribute.

 
WCN_TYPE_SELECTED_REGISTRAR
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method is an integer value, defined by WCN_VALUE_TYPE_BOOLEAN, that indicates if a Registrar has been selected by a user and that an Enrollee can proceed with
setting up an 802.1X uncontrolled data port with the Registrar.
WCN_TYPE_SERIAL_NUMBER
This attribute value indicates that the wszString parameter of the IWCNDevice::GetStringAttribute method is a string containing the serial number of the Enrollee.

Note  Not all devices supply a serial number. Some devices return a string of non-numeric characters, and as a result it is not always possible to convert this value to a number.

 
WCN_TYPE_WI_FI_PROTECTED_SETUP_STATE
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method an integer value, defined by WCN_VALUE_TYPE_WI_FI_PROTECTED_SETUP, that indicates if a device is configured.
WCN_TYPE_SSID
This attribute value indicates that the pbData parameter of the IWCNDevice::GetAttribute method is a buffer, up to 32 bytes in size, containing the Service Set Identifier (SSID) or network name.

Instead of querying this attribute, it is recommended that applications implement IWCNDevice::GetNetworkProfile to retrieve network settings in a convenient format that is ready to be used with the WLAN connection and profile management APIs.
WCN_TYPE_TOTAL_NETWORKS
Reserved. Do not use.
WCN_TYPE_UUID_E
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method is a 16 byte buffer containing the Universally Unique Identifier (UUID) generated by the Enrollee. It
uniquely identifies an operational device and should survive reboots and resets. The UUID is provided in
binary format. If the device also supports UPnP, then the UUID corresponds to the UPnP UUID.

Instead of querying this attribute, applications should instead query the WCN_TYPE_UUID attribute, as it is available for both enrollees and registrars. WCN_TYPE_UUID_E_ is only available for devices that act as an enrollee.
WCN_TYPE_UUID_R
This attribute value indicates that the pbBuffer parameter of the IWCNDevice::GetAttribute method is a 16 byte buffer containing the Universally Unique Identifier (UUID) element generated by the Registrar. It
uniquely identifies an operational device and should survive reboots and resets. The UUID is provided in
binary format. If the device also supports UPnP, then the UUID corresponds to the UPnP UUID.

Instead of querying this attribute, applications should instead query the WCN_TYPE_UUID attribute, as it is available for both enrollees and registrars.
WCN_TYPE_VENDOR_EXTENSION
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetAttribute method is a buffer, up to 1024 bytes in size, that permits the use of vendor extensions in the Wi-Fi Protected Setup TLV framework. The Vendor
Extension figure illustrates the implementation of vendor extensions. Vendor ID is the SMI network management private enterprise code.

Instead of querying this value, implementation of the IWCNDevice::GetVendorExtension API is recommended for convenience and flexibility while accessing the raw vendor extension attribute directly.
WCN_TYPE_VERSION
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method is an integer value that indicates the Wi-Fi Protected Setup version. The one-byte field is broken into a four-bit major part using the
top MSBs and four-bit minor part using the LSBs. As an example, version 3.2 would be 0x32.

Note  Windows will automatically use the correct WPS version for each device, so applications are not required to query or set this value.

 

Note  When using WPS 2.0, WCN_TYPE_VERSION will always be set to 0x10 and WCN_TYPE_VERSION2 is used instead

 
WCN_TYPE_X_509_CERTIFICATE_REQUEST
This attribute value indicates that the pbBuffer parameter of the IWCNDevice::GetAttribute method is a buffer containing an X.509 certificate request payload as specified in RFC 2511.
WCN_TYPE_X_509_CERTIFICATE
This attribute value indicates that the pbBuffer parameter of the IWCNDevice::GetAttribute method is a buffer containing an X.509 certificate.
WCN_TYPE_EAP_IDENTITY
Reserved. Do not use.
WCN_TYPE_MESSAGE_COUNTER
Reserved. Do not use.
WCN_TYPE_PUBLIC_KEY_HASH
This attribute value indicates that the wszString parameter of the IWCNDevice::GetStringAttribute method is a 20 byte buffer containing the first 160 bits of the SHA-256 hash of a public key.

Note  Security is handled transparently by Windows. As a result, applications do not need to query or set this attribute.

 
WCN_TYPE_REKEY_KEY
Reserved. Do not use.
WCN_TYPE_KEY_LIFETIME
Reserved. Do not use.
WCN_TYPE_PERMITTED_CONFIG_METHODS
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method is an integer defined by WCN_VALUE_TYPE_CONFIG_METHODS, that indicates which of the configuration methods supported by the device are enabled.
WCN_TYPE_SELECTED_REGISTRAR_CONFIG_METHODS
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method is an integer defined by WCN_VALUE_TYPE_CONFIG_METHODS, that is used in Probe Response messages to
convey the current supported Config Methods of a specific Registrar.
WCN_TYPE_PRIMARY_DEVICE_TYPE
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method is an 8 byte buffer containing values, contained in WCN_VALUE_TYPE_PRIMARY_DEVICE_TYPE, that indicates the primary type of the device. It is recommended that applications instead query the WCN_TYPE_PRIMARY_DEVICE_TYPE_CATEGORY, WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY_OUI, and WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY attributes as they are more convenient.
WCN_TYPE_SECONDARY_DEVICE_TYPE_LIST
Reserved. Do not use.
WCN_TYPE_PORTABLE_DEVICE
Reserved. Do not use.
WCN_TYPE_AP_SETUP_LOCKED
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method is a buffer containing a value, defined by WCN_VALUE_TYPE_BOOLEAN, that indicates if the access point has entered a state in which it will refuse to allow an external Registrar
to attempt to run the Registration Protocol using the AP’s PIN (with the AP acting as Enrollee). The AP
should enter this state if it believes a brute force attack is underway against the AP’s PIN.
When the AP is in this state, it MUST continue to allow other Enrollees to connect and run the
Registration Protocol with any external Registrars or the AP’s built-in Registrar (if any). It is only the use
of the AP’s PIN for adding external Registrars that is disabled in this state.
The AP Setup Locked state can be reset to FALSE through an authenticated call to SetAPSettings. APs
may provide other implementation-specific methods of resetting the AP Setup Locked state as well.
WCN_TYPE_APPLICATION_EXTENSION
This attribute value indicates that the pvBuffer parameter of the IWCNDevice::GetAttribute method is a buffer, up to 512 bytes in size, used to pass parameters for enabling applications during the WSC
exchange. It is similar to the Vendor Extension attribute except that instead of a 3-byte Vendor ID prefix
to the Vendor Data field, a 16-byte UUID (as defined in RFC 4122) is used. This provides a virtually
unlimited application ID space with a regular structure that can be easily mapped onto a generic
application extension API. Furthermore, the 16-byte UUID value can be used to derive applicationspecific
AMSKs as described in Section 6.3 or pass any necessary keying directly.
WCN_TYPE_EAP_TYPE
Reserved. Do not use.
WCN_TYPE_INITIALIZATION_VECTOR
Reserved. Do not use.
WCN_TYPE_KEY_PROVIDED_AUTOMATICALLY
Reserved. Do not use.
WCN_TYPE_802_1X_ENABLED
Reserved. Do not use.
WCN_TYPE_APPSESSIONKEY
This attribute value represents the buffer, up to 128 bytes in size, containing data that indicates an exchange of application specific session keys and, alternatively, may be used
to calculate AMSKs.
WCN_TYPE_WEPTRANSMITKEY
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method is a 1 byte buffer containing data that identifies the Key Index value used as the Access Point transmit key for WEP configurations.
WCN_TYPE_UUID
This compound attribute indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method is a 16 byte buffer that contains data that is always equal to the UUID of the device, regardless if the device is enrollee or registrar. (Effectively, merges WCN_TYPE_UUID_E and WCN_TYPE_UUID_R).
WCN_TYPE_PRIMARY_DEVICE_TYPE_CATEGORY
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute is an integer that represents the major device category of a WCN device. The major device category is one of the WCN_VALUE_TYPE_DEVICE_TYPE_CATEGORY values.
WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY_OUI
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute is an integer that represents the OUI that defines the device subcategory of a WCN device. The most common OUI is WCN_VALUE_DT_SUBTYPE_WIFI_OUI which indicates that the subcategory is defined by the Wi-Fi Alliance.
WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute is an integer that represents the device subcategory of a WCN device. The subcategory must be interpreted along with the OUI from WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY_OUI. For devices using the Wi-Fi Alliance OUI. The subcategory is one of the WCN_VALUE_TYPE_DEVICE_TYPE_SUBCATEGORY values.
WCN_TYPE_CURRENT_SSID
This attribute value indicates that the wszString parameter of the IWCNDevice::GetStringAttribute method is buffer, up to 32 bytes in size, containing the current SSID of a wireless access point.
WCN_TYPE_BSSID
Reserved. Do not use.
WCN_TYPE_DOT11_MAC_ADDRESS
Reserved. Do not use.
WCN_TYPE_AUTHORIZED_MACS
. This attribute value indicates that a registrar is providing a list of MAC addresses that are authorized to start WSC. The pbBuffer parameter of the IWCNDevice::GetAttribute method is a 6-30 byte buffer containing the 48 bit value of each MAC Address in the list of authorized MACs. For example: 0x00 0x07 0xE9 0x4C 0xA8 0x1C.

Note  Only available in Windows 8.

 
WCN_TYPE_NETWORK_KEY_SHAREABLE
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method is a 1 byte buffer used to get and set network settings for devices that host more than one network. A value of '1' indicates that the Network Key may be shared with other devices.

Note  Only available in Windows 8.

 
WCN_TYPE_REQUEST_TO_ENROLL
Reserved. Do not use.
WCN_TYPE_REQUESTED_DEVICE_TYPE
Reserved. Do not use.
WCN_TYPE_SETTINGS_DELAY_TIME
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method is a 1 byte buffer indicating the estimated length of time (in seconds) that an access point will require to reconfigure itself and become available, or that a device will require to apply settings and connect to a network.

Note  Only available in Windows 8.

 
WCN_TYPE_VERSION2
This attribute value indicates that the puInteger parameter of the IWCNDevice::GetIntegerAttribute method is an integer value that indicates the Wi-Fi Protected Setup version. The one-byte field is broken into a four-bit major part using the
top MSBs and four-bit minor part using the LSBs. As an example, version 3.2 would be 0x32.

Note  Windows will automatically use the correct WPS version for each device, so applications are not required to query or set this value.

 

Note  Only available in Windows 8.

 
WCN_TYPE_VENDOR_EXTENSION_WFA
Reserved. Do not use.

Note  The attributes within the WFA vendor extension may be queried directly.

 
WCN_NUM_ATTRIBUTE_TYPES
The number of assigned attributes.

Requirements

   
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header wcntypes.h