DOT11EXT_SET_DEFAULT_KEY回调函数 (wlanihv.h)
重要本机 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) |