WCN_ATTRIBUTE_TYPE 枚举 (wcntypes.h)

WCN_ATTRIBUTE_TYPE 枚举定义为受保护的 Wi-Fi 安装程序定义的属性缓冲区类型。 每个属性缓冲区占用的总大小包括额外的 4 个字节 (2 个字节的 ID,2 个字节的长度) 。

语法

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;

常量

 
WCN_TYPE_AP_CHANNEL
值: 0
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是包含指定接入点承载的 802.11 通道的数据的值。
WCN_TYPE_ASSOCIATION_STATE
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是一个包含WCN_VALUE_TYPE_ASSOCIATION_STATE定义的关联状态或配置信息的值。
WCN_TYPE_AUTHENTICATION_TYPE
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是包含 WCN_VALUE_TYPE_AUTHENTICATION_TYPE 定义的身份验证类型的值。
WCN_TYPE_AUTHENTICATION_TYPE_FLAGS
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是一个包含数据的值,该值通过提供 来指定 Enrollee (接入点或工作站) 的网络身份验证功能
由 WCN_VALUE_TYPE_AUTHENTICATION_TYPE 定义的值。
WCN_TYPE_AUTHENTICATOR
此属性值指示 IWCNDevice::GetStringAttribute 方法的 wszString 参数是包含数据的键控哈希的缓冲区。

注意 Windows 以透明方式处理安全性。 因此,应用程序不需要查询或设置此属性。

 
WCN_TYPE_CONFIG_METHODS
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数包含由 WCN_VALUE_TYPE_CONFIG_METHODS 定义的值,这些值指定了 Enrollee 或 Registrar 支持的配置方法。 此外,接入点和工作站
支持 UPnP 管理接口的 还必须支持此属性,该属性
用于控制在访问点上启用的配置方法。
WCN_TYPE_CONFIGURATION_ERROR
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是由 WCN_VALUE_TYPE_CONFIGURATION_ERROR 定义的值,该值指定设备尝试配置自身并与 WLAN 关联的结果。

如果配置会话失败并出现错误代码WCN_E_CONNECTION_REJECTED,则可以通过查询此属性来获取远程设备返回的任何错误代码。 请务必注意,即使发生错误,某些设备也会返回WCN_VALUE_CE_NO_ERROR。
WCN_TYPE_CONFIRMATION_URL4
此属性值指示 IWCNDevice::GetStringAttribute 方法的 wszString 参数是一个缓冲区,其中包含表示 URL (IPv4 地址的数据,) 由注册机构提供给注册者,用于发布确认
成功应用设置并加入网络后。 此配置
参数对于注册器是可选的,如果注册器是可选的,则注册者可以发布到 URL
包括它。

注意 注册者不得连接到位于其他子网上的确认 URL。

 
WCN_TYPE_CONFIRMATION_URL6
此属性值指示 IWCNDevice::GetStringAttribute 方法的 wszString 参数是包含表示 URL (IPv6 地址的数据的缓冲区,) 由注册机构提供给注册者,用于发布确认
成功应用设置并加入网络后。 此配置
参数对于注册器是可选的,如果注册器是可选的,则注册者可发布到 URL
包括它。

注意 注册者不得连接到位于其他子网上的确认 URL。

 
WCN_TYPE_CONNECTION_TYPE
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数包含由 WCN_VALUE_TYPE_CONNECTION_TYPE 定义的值,该值指定了 Enrollee 的连接功能。
WCN_TYPE_CONNECTION_TYPE_FLAGS
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数包含由 WCN_VALUE_TYPE_CONNECTION_TYPE 定义的值,该值指定了 Enrollee 的连接功能。
WCN_TYPE_CREDENTIAL
此复合属性值指示 IWCNDevice::GetAttribute 方法的 pbBuffer 参数包含单个 WLAN 凭据。 每个网络密钥可以有多个凭据属性,也可以有多个
单个凭据属性中的网络密钥,这是通过重复网络密钥索引和属性来实现的
关注它。 通常,多个
应使用单个 SSID 的单个凭据中的密钥,并针对 使用多个凭据属性
应使用单独的 SSD。 以下属性包含在凭据的每个实例中:


  • WCN_TYPE_AUTHENTICATION_TYPE

  • WCN_TYPE_ENCRYPTION_TYPE

  • WCN_TYPE_SSID

  • WCN_TYPE_NETWORK_INDEX


如果应用程序打算将网络凭据与 WLAN API 配合使用,则应使用 IWCNDevice::GetNetworkProfile 直接获取兼容的 XML 网络配置文件。
WCN_TYPE_DEVICE_NAME
此属性值指示 IWCNDevice::GetStringAttribute 方法的 wszString 参数是一个缓冲区,其中包含以 UTF-8 编码的设备的用户友好说明。 通常,组件
将是一个唯一标识符,它以用户可识别的方式描述产品。
WCN_TYPE_DEVICE_PASSWORD_ID
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数包含由 WCN VALUE TYPE DEVICE_PASSWORD_ID 定义的值,该值用于标识设备密码。
WCN_TYPE_E_HASH1
此属性值指示 IWCNDevice::GetAttribute 方法的 pbBuffer 参数包含设备密码的前半部分的 HMAC-SHA-256 哈希和注册者的第一个机密
Nonce。

注意 Windows 以透明方式处理安全性。 因此,应用程序不需要查询或设置此属性。

 
WCN_TYPE_E_HASH2
此属性值指示 IWCNDevice::GetAttribute 方法的 pbBuffer 参数包含设备密码后半部分的 HMAC-SHA-256 哈希,以及注册者的第二个哈希
机密 nonce。

注意 Windows 以透明方式处理安全性。 因此,应用程序不需要查询或设置此属性。

 
WCN_TYPE_E_SNONCE1
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数包含注册者使用的设备密码的前半部分的第一个 nonce。

注意 Windows 以透明方式处理安全性。 因此,应用程序不需要查询或设置此属性。

 
WCN_TYPE_E_SNONCE2
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数包含注册者使用的第二个 nonce 以及设备密码的后半部分。

注意 Windows 以透明方式处理安全性。 因此,应用程序不需要查询或设置此属性。

 
WCN_TYPE_ENCRYPTED_SETTINGS
此属性值指示 IWCNDevice::GetAttribute 方法的 pbBuffer 参数包含初始化向量 (IV) 后跟一个集
加密 Wi-Fi 受保护的安装程序 TLV 属性。 加密集中的最后一个属性是密钥包装
根据第 6.5 节中所述的过程计算的验证器。

注意 Windows 以透明方式处理安全性。 因此,应用程序不需要查询或设置此属性。

 
WCN_TYPE_ENCRYPTION_TYPE
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数包含由 WCN_VALUE_TYPE_ENCRYPTION_TYPE 定义的值,用于注册者 (AP 或
要使用的工作站) 。
WCN_TYPE_ENCRYPTION_TYPE_FLAGS
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数包含由 WCN_VALUE_TYPE_ENCRYPTION_TYPE 定义的值,用于注册者 (AP 或
要使用的工作站) 。
WCN_TYPE_ENROLLEE_NONCE
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数包含随机生成的二进制值,该值由注册者创建
安装操作。

注意 Windows 以透明方式处理安全性。 因此,应用程序不需要查询或设置此属性。

 
WCN_TYPE_FEATURE_ID
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数包含指示设备上运行的操作系统的特定功能生成的数据。 4 字节整数中最重要的有效位是保留的,并且始终设置为 1。
WCN_TYPE_IDENTITY
保留。 请勿使用。
WCN_TYPE_IDENTITY_PROOF
保留。 请勿使用。
WCN_TYPE_KEY_WRAP_AUTHENTICATOR
此属性值指示 IWCNDevice::GetStringAttribute 方法的 wszString 参数是包含 HMAC-SHA-256 的前 64 位的 8 字节缓冲区,该缓冲区通过要加密的数据计算
替换为密钥换行算法。 在加密之前,它将追加到 ConfigData 的末尾。

注意 Windows 以透明方式处理安全性。 因此,应用程序不需要查询或设置此属性。

 
WCN_TYPE_KEY_IDENTIFIER
此属性值指示 IWCNDevice::GetAttribute 方法的 wszString 参数是包含 128 位密钥标识符的 16 字节缓冲区。 如果此属性紧接在加密数据之前
或 Authenticator 属性,则应使用与 128 位标识符对应的密钥来解密
或验证“数据”字段。
WCN_TYPE_MAC_ADDRESS
此属性值指示 IWCNDevice::GetAttribute 方法的 pbBuffer 参数是包含 MAC 地址的 48 位值的 6 字节缓冲区。 For
示例:0x00 0x07 0xE9 0x4C 0xA8 0x1C。

此地址由远程设备提供。 某些接入点提供其以太网接口的 MAC 地址,在这种情况下,该地址不能用于查找 AP 的无线无线电。 如果应用程序需要查找 AP 的无线电,则应用程序应查询由 Windows 填充且通常更可靠的 WCN_TYPE_BSSID 属性。
WCN_TYPE_MANUFACTURER
此属性值指示 IWCNDevice::GetAttribute 方法的 pbBuffer 参数是包含标识设备制造商的字符串的缓冲区。
通常,此字段应允许用户与带有 上标记的设备关联
快速获取答案。
WCN_TYPE_MESSAGE_TYPE
保留。 请勿使用。
WCN_TYPE_MODEL_NAME
此属性值指示 IWCNDevice::GetStringAttribute 方法的 wszString 参数是标识设备模型的缓冲区。 通常,此字段
应允许用户创建具有设备上的标记的设备关联。
WCN_TYPE_MODEL_NUMBER
此属性值指示 IWCNDevice::GetStringAttribute 方法的 wszString 参数是包含与设备关联的其他描述性数据的字符串。
WCN_TYPE_NETWORK_INDEX
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是一个 1 字节缓冲区,用于获取和设置托管多个网络的设备的网络设置。 The
默认值为“1”,表示设备上的主 WLAN 网络。
WCN_TYPE_NETWORK_KEY
此属性值指示 IWCNDevice::GetStringAttribute 方法的 wszString 参数是包含注册者要使用的无线加密密钥的缓冲区。 请注意,建议应用程序实现 IWCNDevice::GetNetworkProfile ,以方便的格式获取网络设置,该格式已准备好与 WLAN 连接和配置文件管理 API 一起使用。
WCN_TYPE_NETWORK_KEY_INDEX
保留。 请勿使用。
WCN_TYPE_NEW_DEVICE_NAME
保留。 请勿使用。
WCN_TYPE_NEW_PASSWORD
保留。 请勿使用。
WCN_TYPE_OOB_DEVICE_PASSWORD
保留。 请勿使用。
WCN_TYPE_OS_VERSION
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是包含设备上运行的操作系统版本的 4 字节缓冲区。 此 4 字节字段中最重要的有效位是保留的,并且始终设置为 1。
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
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是一个 16 字节缓冲区,其中包含由注册器创建的随机生成的二进制值
设置。

注意 Windows 以透明方式处理安全性。 因此,应用程序不需要查询或设置此属性。

 
WCN_TYPE_REQUEST_TYPE
保留。 请勿使用。
WCN_TYPE_RESPONSE_TYPE
保留。 请勿使用。
WCN_TYPE_RF_BANDS
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是一个整数值,由 WCN_VALUE_TYPE_RF_BANDS 定义,指示在消息交换期间使用哪个 RF 波段,允许结束
通过一致的无线电接口进行通信的点和代理。 它还可用作可选
WCN_TYPE_CREDENTIALWCN_TYPE_ENCRYPTED_SETTINGS中的 属性,用于指示 特定 (或 RF 波段的组)
设置适用。
WCN_TYPE_R_HASH1
此属性值指示 IWCNDevice::GetStringAttribute 方法的 wszString 参数是包含设备密码的前半部分 HMAC-SHA-256 哈希和注册器的第一个机密的 32 字节缓冲区
Nonce。

注意 Windows 以透明方式处理安全性。 因此,应用程序不需要查询或设置此属性。

 
WCN_TYPE_R_HASH2
此属性值指示 IWCNDevice::GetStringAttribute 方法的 wszString 参数是一个 32 字节缓冲区,其中包含设备密码后半部分的 HMAC-SHA-256 哈希和注册器的第二个
机密 nonce。

注意 Windows 以透明方式处理安全性。 因此,应用程序不需要查询或设置此属性。

 
WCN_TYPE_R_SNONCE1
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是一个 16 字节缓冲区,其中包含注册器使用设备密码的前半部分的第一个 nonce。

注意 Windows 以透明方式处理安全性。 因此,应用程序不需要查询或设置此属性。

 
WCN_TYPE_R_SNONCE2
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是一个 16 字节缓冲区,其中包含注册器使用的设备密码后半部分的第二个 nonce。

注意 Windows 以透明方式处理安全性。 因此,应用程序不需要查询或设置此属性。

 
WCN_TYPE_SELECTED_REGISTRAR
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是一个整数值,由 WCN_VALUE_TYPE_BOOLEAN 定义,该值指示注册器是否已由用户选择,并且注册者可以继续使用
使用注册器设置 802.1X 不受控制的数据端口。
WCN_TYPE_SERIAL_NUMBER
此属性值指示 IWCNDevice::GetStringAttribute 方法的 wszString 参数是包含注册人的序列号的字符串。

注意 并非所有设备都提供序列号。 某些设备返回非数字字符的字符串,因此并不总是可以将此值转换为数字。

 
WCN_TYPE_WI_FI_PROTECTED_SETUP_STATE
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是一个整数值,由 WCN_VALUE_TYPE_WI_FI_PROTECTED_SETUP 定义,指示是否已配置设备。
WCN_TYPE_SSID
此属性值指示 IWCNDevice::GetAttribute 方法的 pbData 参数是一个缓冲区,最大大小为 32 个字节,包含服务集标识符 (SSID) 或网络名称。

建议应用程序实现 IWCNDevice::GetNetworkProfile ,而不是查询此属性,以方便的格式检索网络设置,该格式已准备好与 WLAN 连接和配置文件管理 API 一起使用。
WCN_TYPE_TOTAL_NETWORKS
保留。 请勿使用。
WCN_TYPE_UUID_E
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是包含注册者生成的通用唯一标识符 (UUID) 的 16 字节缓冲区。 它
唯一标识可操作的设备,并且应在重新启动和重置后幸存下来。 UUID 在
二进制格式。 如果设备还支持 UPnP,则 UUID 对应于 UPnP UUID。

应用程序应查询WCN_TYPE_UUID属性,而不是查询此属性,因为它适用于注册者和注册机构。 WCN_TYPE_UUID_E_仅适用于充当注册者的设备。
WCN_TYPE_UUID_R
此属性值指示 IWCNDevice::GetAttribute 方法的 pbBuffer 参数是包含注册器生成的通用唯一标识符 (UUID) 元素的 16 字节缓冲区。 它
唯一标识可操作的设备,并且应在重新启动和重置后幸存下来。 UUID 在
二进制格式。 如果设备还支持 UPnP,则 UUID 对应于 UPnP UUID。

应用程序应查询WCN_TYPE_UUID属性,而不是查询此属性,因为它同时适用于注册者和注册机构。
WCN_TYPE_VENDOR_EXTENSION
此属性值指示 IWCNDevice::GetAttribute 方法的 puInteger 参数是一个缓冲区,最大大小为 1024 字节,允许在 Wi-Fi Protected 安装程序 TLV 框架中使用供应商扩展。 供应商
扩展图说明了供应商扩展的实现。 供应商 ID 是 SMI 网络管理专用企业代码。

为了方便和灵活地直接访问原始供应商扩展属性,建议实现 IWCNDevice::GetVendorExtension API,而不是查询此值。
WCN_TYPE_VERSION
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是一个整数值,指示 Wi-Fi 受保护的安装程序版本。 使用 将单字节字段分解为四位主要部分
使用 LSB 的顶部 MSB 和四位次要部分。 例如,版本 3.2 将0x32。

注意 Windows 将自动为每个设备使用正确的 WPS 版本,因此应用程序不需要查询或设置此值。

 

注意使用 WPS 2.0 时,WCN_TYPE_VERSION始终设置为0x10,改用WCN_TYPE_VERSION2

 
WCN_TYPE_X_509_CERTIFICATE_REQUEST
此属性值指示 IWCNDevice::GetAttribute 方法的 pbBuffer 参数是包含 RFC 2511 中指定的 X.509 证书请求有效负载的缓冲区。
WCN_TYPE_X_509_CERTIFICATE
此属性值指示 IWCNDevice::GetAttribute 方法的 pbBuffer 参数是包含 X.509 证书的缓冲区。
WCN_TYPE_EAP_IDENTITY
保留。 请勿使用。
WCN_TYPE_MESSAGE_COUNTER
保留。 请勿使用。
WCN_TYPE_PUBLIC_KEY_HASH
此属性值指示 IWCNDevice::GetStringAttribute 方法的 wszString 参数是包含公钥 SHA-256 哈希的前 160 位的 20 字节缓冲区。

注意 Windows 以透明方式处理安全性。 因此,应用程序不需要查询或设置此属性。

 
WCN_TYPE_REKEY_KEY
保留。 请勿使用。
WCN_TYPE_KEY_LIFETIME
保留。 请勿使用。
WCN_TYPE_PERMITTED_CONFIG_METHODS
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是由 WCN_VALUE_TYPE_CONFIG_METHODS 定义的整数,指示启用了设备支持的哪些配置方法。
WCN_TYPE_SELECTED_REGISTRAR_CONFIG_METHODS
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是由 WCN_VALUE_TYPE_CONFIG_METHODS 定义的整数,在探测响应消息中用于
传达特定注册器当前支持的配置方法。
WCN_TYPE_PRIMARY_DEVICE_TYPE
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是一个 8 字节缓冲区,其中包含WCN_VALUE_TYPE_PRIMARY_DEVICE_TYPE中包含的值,指示设备的主要类型。 建议应用程序查询WCN_TYPE_PRIMARY_DEVICE_TYPE_CATEGORY、WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY_OUI和WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY属性,因为它们更方便。
WCN_TYPE_SECONDARY_DEVICE_TYPE_LIST
保留。 请勿使用。
WCN_TYPE_PORTABLE_DEVICE
保留。 请勿使用。
WCN_TYPE_AP_SETUP_LOCKED
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是包含值(由 WCN_VALUE_TYPE_BOOLEAN 定义的)的缓冲区,该值指示访问点是否已进入拒绝允许外部注册器的状态
尝试使用 AP 的 PIN (运行注册协议,并且 AP 充当注册者) 。 美联社
如果它认为正在针对 AP 的 PIN 进行暴力攻击,则应进入此状态。
当 AP 处于此状态时,它必须继续允许其他注册者连接并运行
任何外部注册机构或 AP 的内置注册器 (注册协议(如果有任何) )。 它只是使用
用于添加在此状态下禁用的外部注册机构的 AP 的 PIN。
可以通过对 SetAPSettings 的经过身份验证的调用将 AP 安装程序锁定状态重置为 FALSE 。 Aps
还可以提供其他特定于实现的方法来重置 AP 安装程序锁定状态。
WCN_TYPE_APPLICATION_EXTENSION
此属性值指示 IWCNDevice::GetAttribute 方法的 pvBuffer 参数是一个缓冲区,最大大小为 512 字节,用于传递参数以在 WSC 期间启用应用程序
交换。 它类似于供应商扩展属性,不同之处在于,它不是 3 字节的供应商 ID 前缀
对于“供应商数据”字段,将使用 RFC 4122) 中定义的 16 字节 UUID (。 这提供了一个虚拟的
无限的应用程序 ID 空间,具有可轻松映射到泛型的常规结构
应用程序扩展 API。 此外,16 字节 UUID 值可用于派生应用程序特定值
如第 6.3 节中所述的 AMSK 或直接传递任何必要的密钥。
WCN_TYPE_EAP_TYPE
保留。 请勿使用。
WCN_TYPE_INITIALIZATION_VECTOR
保留。 请勿使用。
WCN_TYPE_KEY_PROVIDED_AUTOMATICALLY
保留。 请勿使用。
WCN_TYPE_802_1X_ENABLED
保留。 请勿使用。
WCN_TYPE_APPSESSIONKEY
此属性值表示缓冲区,最大为 128 字节,包含指示交换应用程序特定会话密钥的数据,也可以使用
用于计算 AMSK。
WCN_TYPE_WEPTRANSMITKEY
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是一个 1 字节缓冲区,其中包含标识用作 WEP 配置的接入点传输密钥的 Key Index 值的数据。
WCN_TYPE_UUID
此复合属性指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是包含始终等于设备的 UUID 的数据的 16 字节缓冲区,无论设备是注册者还是注册机构。 (有效地合并WCN_TYPE_UUID_E和WCN_TYPE_UUID_R) 。
WCN_TYPE_PRIMARY_DEVICE_TYPE_CATEGORY
此属性值指示 IWCNDevice::GetIntegerAttributepuInteger 参数是一个整数,表示 WCN 设备的主要设备类别。 主要设备类别是WCN_VALUE_TYPE_DEVICE_TYPE_CATEGORY值之一。
WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY_OUI
此属性值指示 IWCNDevice::GetIntegerAttributepuInteger 参数是一个整数,表示定义 WCN 设备的设备子类别的 OUI。 最常见的 OUI 是WCN_VALUE_DT_SUBTYPE_WIFI_OUI指示子类别由 Wi-Fi 联盟定义。
WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY
此属性值指示 IWCNDevice::GetIntegerAttributepuInteger 参数是一个整数,表示 WCN 设备的设备子类别。 子类别必须与WCN_TYPE_PRIMARY_DEVICE_TYPE_SUBCATEGORY_OUI的 OUI 一起解释。 对于使用 Wi-Fi Alliance OUI 的设备。 子类别是WCN_VALUE_TYPE_DEVICE_TYPE_SUBCATEGORY值之一。
WCN_TYPE_CURRENT_SSID
此属性值指示 IWCNDevice::GetStringAttribute 方法的 wszString 参数是缓冲区,最大为 32 字节,包含无线接入点的当前 SSID。
WCN_TYPE_BSSID
保留。 请勿使用。
WCN_TYPE_DOT11_MAC_ADDRESS
保留。 请勿使用。
WCN_TYPE_AUTHORIZED_MACS
. 此属性值指示注册机构提供有权启动 WSC 的 MAC 地址列表。 IWCNDevice::GetAttribute 方法的 pbBuffer 参数是一个 6-30 字节缓冲区,其中包含授权 MAC 列表中每个 MAC 地址的 48 位值。 例如:0x00 0x07 0xE9 0x4C 0xA8 0x1C。

注意仅在 Windows 8 中可用。

 
WCN_TYPE_NETWORK_KEY_SHAREABLE
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是一个 1 字节缓冲区,用于获取和设置托管多个网络的设备的网络设置。 值“1”表示网络密钥可以与其他设备共享。

注意仅在 Windows 8 中可用。

 
WCN_TYPE_REQUEST_TO_ENROLL
保留。 请勿使用。
WCN_TYPE_REQUESTED_DEVICE_TYPE
保留。 请勿使用。
WCN_TYPE_SETTINGS_DELAY_TIME
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是一个 1 字节缓冲区,指示访问点需要重新配置自身并变为可用,或者设备需要应用设置并连接到网络) 估计 (的时间长度(以秒为单位)。

注意仅在 Windows 8 中可用。

 
WCN_TYPE_VERSION2
此属性值指示 IWCNDevice::GetIntegerAttribute 方法的 puInteger 参数是一个整数值,指示 Wi-Fi 受保护的安装程序版本。 使用 将单字节字段分解为四位主要部分
使用 LSB 的顶部 MSB 和四位次要部分。 例如,版本 3.2 将0x32。

注意 Windows 将自动为每个设备使用正确的 WPS 版本,因此应用程序不需要查询或设置此值。

 

注意仅在 Windows 8 中可用。

 
WCN_TYPE_VENDOR_EXTENSION_WFA
保留。 请勿使用。

注意 WFA 供应商扩展中的属性可以直接查询。

 
WCN_NUM_ATTRIBUTE_TYPES
分配的属性数。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 wcntypes.h