DOT11EXT_SET_DEFAULT_KEY_ID回调函数 (wlanihv.h)

  • 项目
重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。 请改用 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_DOT11_CIPHER_DEFAULT_KEY_ID 对象标识符 (OID) 管理 WLAN 适配器的 Native 802.11 微型端口驱动程序。

要求

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

另请参阅

OID_DOT11_CIPHER_DEFAULT_KEY_ID

Dot11ExtIhvInitAdapter

802.11 密码密钥类型