DOT11EXT_SET_DEFAULT_KEY回调函数（wlanihv.h）

项目
02/07/2025

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

IHV 扩展 DLL 调用 Dot11ExtSetDefaultKey 函数，从无线 LAN （WLAN）适配器的默认密钥表或每站默认密钥表添加或删除密码密钥。有关这些密钥类型的详细信息，请参阅 802.11 密码密钥类型。

语法

DOT11EXT_SET_DEFAULT_KEY Dot11extSetDefaultKey;

DWORD Dot11extSetDefaultKey(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           PDOT11_CIPHER_DEFAULT_KEY_VALUE pKey,
  [in]           DOT11_DIRECTION dot11Direction
)
{...}

参数

[in, optional] hDot11SvcHandle

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

[in] pKey

指向 DOT11_CIPHER_DEFAULT_KEY_VALUE 结构，用于定义密码密钥。

[in] dot11Direction

一个 DOT11_DIRECTION 值，该值指定密钥是只能用于接收的数据包（DOT11_DIR_INBOUND），还是同时用于接收和发送的数据包（DOT11_DIR_BOTH）。

注意 IHV 扩展 DLL 不能将 DOT11_DIR_OUTBOUND 的值传递给此参数。

返回值

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

言论

对 Dot11ExtSetDefaultKey 函数的调用会导致设置请求 OID_DOT11_CIPHER_DEFAULT_KEY WLAN 适配器的对象标识符。

通过设置 MacAddr 成员来定义默认密码密钥将结构 DOT11_CIPHER_DEFAULT_KEY_VALUE 为0x000000000000的值。通过将 MacAddr 成员设置为有效的单播媒体访问控制（MAC）地址来定义每个工作站的默认密码密钥。

如果 bDelete 成员，则会从适配器的密钥表中删除密码密钥 DOT11_CIPHER_DEFAULT_KEY_VALUE 结构设置为 TRUE。

要求

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