通过

DOT11EXT_SET_DEFAULT_KEY_ID回调函数 （wlanihv.h）

  • 项目
重要 Windows 10 及更高版本中弃用了 Native 802.11 无线 LAN 接口。 请改用 WLAN 设备驱动程序接口（WDI）。 有关 WDI 的详细信息，请参阅 WLAN 通用 Windows 驱动程序模型。
 
IHV 扩展 DLL 调用 Dot11ExtSetDefaultKeyId 函数，以设置无线 LAN （WLAN） 适配器在加密传输数据包数据时默认使用的默认或每站密码密钥的表索引。

语法

DOT11EXT_SET_DEFAULT_KEY_ID Dot11extSetDefaultKeyId;

DWORD Dot11extSetDefaultKeyId(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           ULONG uDefaultKeyId
)
{...}

参数

[in, optional] hDot11SvcHandle

作系统用于引用 WLAN 适配器的句柄。 此句柄值是通过上一次调用 Dot11ExtIhvInitAdapter IHV 处理程序函数指定的。

[in] uDefaultKeyId

适配器的默认或每站密码密钥表中密钥的索引值。

对于标准 802.11 密码算法（如 WEP 或 TKIP），uDefaultKeyId 必须为 0 到 3。 对于 IHV 开发的专有密码算法，uDefaultKeyId 可以是 IHV 定义的范围内的任何值。

返回值

如果调用成功，函数将返回ERROR_SUCCESS。 否则，它将返回 Winerror.h 中定义的错误代码。

言论

默认密钥标识符（ID）指定适配器的默认密钥和适配器用于数据加密的每个工作站默认密钥表中密码密钥的索引。 适配器使用默认密钥 ID 引用的密码密钥作为传输数据包的默认加密密钥，除非目标媒体访问控制 （MAC） 地址存在密钥映射密钥。 有关这些密码密钥类型的详细信息，请参阅 802.11 密码密钥类型。

对 Dot11ExtSetDefaultKeyId 函数的调用会导致设置请求将对象标识符 （OID） OID_DOT11_CIPHER_DEFAULT_KEY_ID 到管理 WLAN 适配器的 Native 802.11 微型端口驱动程序。

要求

要求 价值
最低支持的客户端 在 Windows Vista 和更高版本的 Windows作系统中可用。
目标平台 桌面
标头 wlanihv.h （包括 Wlanihv.h）

另请参阅

OID_DOT11_CIPHER_DEFAULT_KEY_ID

Dot11ExtIhvInitAdapter

802.11 密码密钥类型