windot11.h) (DOT11_AUTH_CIPHER_PAIR_LIST 结构

重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。 请改用 WLAN 设备驱动程序接口 (WDI) 。 有关 WDI 的详细信息，请参阅 WLAN 通用 Windows 驱动程序模型。

 

DOT11_AUTH_CIPHER_PAIR_LIST 结构定义DOT11_AUTH_CIPHER_PAIR结构的列表。

语法

typedef struct DOT11_AUTH_CIPHER_PAIR_LIST {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  uNumOfEntries;
  ULONG                  uTotalNumOfEntries;
  DOT11_AUTH_CIPHER_PAIR AuthCipherPairs[1];
} DOT11_AUTH_CIPHER_PAIR_LIST, *PDOT11_AUTH_CIPHER_PAIR_LIST;

成员

Header

DOT11_AUTH_CIPHER_PAIR_LIST 结构的类型、修订和大小。 此成员的格式设置为 NDIS_OBJECT_HEADER 结构。

微型端口驱动程序必须将 Header 的成员设置为以下值：

类型

此成员必须设置为 NDIS_OBJECT_TYPE_DEFAULT。

修订

此成员必须设置为 DOT11_AUTH_CIPHER_PAIR_LIST_REVISION_1。

大小

此成员必须设置为 sizeof(DOT11_AUTH_CIPHER_PAIR_LIST)。

有关这些成员的详细信息，请参阅 NDIS_OBJECT_HEADER。

uNumOfEntries

AuthCipherPairs 数组中的条目数。

uTotalNumOfEntries

AuthCipherPairs 数组可以包含的最大条目数。

AuthCipherPairs[1]

的列表 DOT11_AUTH_CIPHER_PAIR 结构。

注解

微型端口驱动程序在任一查询时返回DOT11_AUTH_CIPHER_PAIR_LIST结构 OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR 或 OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR。

查询这些 OID 时，微型端口驱动程序必须验证 MiniportOidRequest 函数的 OidRequest 参数的 InformationBuffer 成员是否足够大，足以返回整个DOT11_AUTH_CIPHER_PAIR_LIST结构，包括 AuthCipherPairs 数组中的所有条目。 OidRequest 参数的 InformationBufferLength 成员的值确定微型端口驱动程序必须执行的操作，如以下列表所示：

• 如果 InformationBufferLength 成员的值小于整个 DOT11_AUTH_CIPHER_PAIR_LIST 结构的长度（以字节为单位），微型端口驱动程序必须执行以下操作：
  • 对于 OidRequest 参数，将 BytesWritten 成员设置为零， 将 BytesNeeded 成员设置为整个 DOT11_AUTH_CIPHER_PAIR_LIST 结构的长度（以字节为单位）。
  • 通过从 其 MiniportOidRequest 函数返回NDIS_STATUS_BUFFER_OVERFLOW，使查询请求失败。
• 如果 InformationBufferLength 成员的值大于或等于整个 DOT11_AUTH_CIPHER_PAIR_LIST 结构的长度（以字节为单位），微型端口驱动程序必须执行以下操作才能成功完成查询请求：
  • 对于 DOT11_AUTH_CIPHER_PAIR_LIST 结构，请将 uNumOfEntries 和 uTotalNumOfEntries 成员设置为 AuthCipherPairs 数组中的条目总数。
  • 对于 OidRequest 参数，将 BytesNeeded 成员设置为零， 将 BytesWritten 成员设置为整个 DOT11_AUTH_CIPHER_PAIR_LIST 结构的长度（以字节为单位）。 微型端口驱动程序还必须将整个 DOT11_AUTH_CIPHER_PAIR_LIST 结构复制到 InformationBuffer 成员。
  • 从其 MiniportOidRequest 函数返回NDIS_STATUS_SUCCESS。

从 Windows 7 开始，802.11 微型端口驱动程序可以报告DOT11_AUTH_CIPHER_PAIR_LIST中支持的身份验证和密码算法对的任意组合。 但是，如果操作系统启动软 AP，它将仅启用 DOT11_AUTH_ALGO_RSNA_PSK 身份验证算法和 DOT11_CIPHER_ALGO_CCMP 密码算法。 若要支持软 AP，微型端口驱动程序必须支持此身份验证/密码对。

如果在在 Extensible AP 模式下运行的 NIC 上启用了 WPS，则微型端口驱动程序必须允许对等站通过使用 开放系统身份验证 或 有线等效隐私 (WEP) 算法与可扩展 AP 关联，而不考虑已启用的授权和密码算法。 有关 WPS 和 Extensible AP 的详细信息，请参阅 OID_DOT11_WPS_ENABLED。

要求

要求	值
最低受支持的客户端	在 Windows Vista 和更高版本的 Windows 操作系统中可用。
标头	windot11.h (包括 Ndis.h)

另请参阅

OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_AUTH_CIPHER_PAIR

NDIS_OBJECT_HEADER