DOT11EXT_SET_DEFAULT_KEY回调函数 (wlanihv.h)

项目
02/27/2024

重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。请改用 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)