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 = 0,
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_CHANNELValue: 0 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_STATEThis 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_TYPEThis 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_FLAGSThis 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_AUTHENTICATORThis 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_METHODSThis 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_ERRORThis 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_URL4This 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_URL6This 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_TYPEThis 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_FLAGSThis 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_CREDENTIALThis 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:
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_NAMEThis 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_IDThis 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_HASH1This 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_HASH2This 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_SNONCE1This 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_SNONCE2This 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_SETTINGSThis 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_TYPEThis 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_FLAGSThis 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_NONCEThis 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_IDThis 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_IDENTITYReserved. Do not use. |
WCN_TYPE_IDENTITY_PROOFReserved. Do not use. |
WCN_TYPE_KEY_WRAP_AUTHENTICATORThis 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_IDENTIFIERThis 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_ADDRESSThis 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_MANUFACTURERThis 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_TYPEReserved. Do not use. |
WCN_TYPE_MODEL_NAMEThis 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_NUMBERThis 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_INDEXThis 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_KEYThis 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_INDEXReserved. Do not use. |
WCN_TYPE_NEW_DEVICE_NAMEReserved. Do not use. |
WCN_TYPE_NEW_PASSWORDReserved. Do not use. |
WCN_TYPE_OOB_DEVICE_PASSWORDReserved. Do not use. |
WCN_TYPE_OS_VERSIONThis 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_LEVELReserved. Do not use. |
WCN_TYPE_PSK_CURRENTReserved. Do not use. |
WCN_TYPE_PSK_MAXReserved. Do not use. |
WCN_TYPE_PUBLIC_KEYReserved. 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_ENABLEDReserved. Do not use. |
WCN_TYPE_REBOOTReserved. Do not use. |
WCN_TYPE_REGISTRAR_CURRENTReserved. Do not use. |
WCN_TYPE_REGISTRAR_ESTABLISHEDReserved. Do not use. |
WCN_TYPE_REGISTRAR_LISTReserved. Do not use. |
WCN_TYPE_REGISTRAR_MAXReserved. Do not use. |
WCN_TYPE_REGISTRAR_NONCEThis 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_TYPEReserved. Do not use. |
WCN_TYPE_RESPONSE_TYPEReserved. Do not use. |
WCN_TYPE_RF_BANDSThis 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_HASH1This 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_HASH2This 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_SNONCE1This 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_SNONCE2This 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_REGISTRARThis 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_NUMBERThis 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_STATEThis 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_SSIDThis 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_NETWORKSReserved. Do not use. |
WCN_TYPE_UUID_EThis 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_RThis 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_EXTENSIONThis 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_VERSIONThis 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_REQUESTThis 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_CERTIFICATEThis attribute value indicates that the pbBuffer parameter of the IWCNDevice::GetAttribute method is a buffer containing an X.509 certificate. |
WCN_TYPE_EAP_IDENTITYReserved. Do not use. |
WCN_TYPE_MESSAGE_COUNTERReserved. Do not use. |
WCN_TYPE_PUBLIC_KEY_HASHThis 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_KEYReserved. Do not use. |
WCN_TYPE_KEY_LIFETIMEReserved. Do not use. |
WCN_TYPE_PERMITTED_CONFIG_METHODSThis 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_METHODSThis 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_TYPEThis 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_LISTReserved. Do not use. |
WCN_TYPE_PORTABLE_DEVICEReserved. Do not use. |
WCN_TYPE_AP_SETUP_LOCKEDThis 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_EXTENSIONThis 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_TYPEReserved. Do not use. |
WCN_TYPE_INITIALIZATION_VECTORReserved. Do not use. |
WCN_TYPE_KEY_PROVIDED_AUTOMATICALLYReserved. Do not use. |
WCN_TYPE_802_1X_ENABLEDReserved. Do not use. |
WCN_TYPE_APPSESSIONKEYThis 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_WEPTRANSMITKEYThis 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_UUIDThis 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_CATEGORYThis 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_OUIThis 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_SUBCATEGORYThis 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_SSIDThis 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_BSSIDReserved. Do not use. |
WCN_TYPE_DOT11_MAC_ADDRESSReserved. 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_SHAREABLEThis 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_ENROLLReserved. Do not use. |
WCN_TYPE_REQUESTED_DEVICE_TYPEReserved. Do not use. |
WCN_TYPE_SETTINGS_DELAY_TIMEThis 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_VERSION2This 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_WFAReserved. Do not use. Note The attributes within the WFA vendor extension may be queried directly. |
WCN_NUM_ATTRIBUTE_TYPESThe number of assigned attributes. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Header | wcntypes.h |
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for