DOT11EXT_SET_UNICAST_CIPHER_ALGORITHM回调函数 (wlanihv.h)

重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。 请改用 WLAN 设备驱动程序接口 (WDI) 。 有关 WDI 的详细信息,请参阅 WLAN 通用 Windows 驱动程序模型

IHV 扩展 DLL 调用 Dot11ExtSetUnicastCipherAlgorithm 函数,以便在无线 LAN (WLAN) 适配器上启用单播密码算法。

语法

DOT11EXT_SET_UNICAST_CIPHER_ALGORITHM Dot11extSetUnicastCipherAlgorithm;

DWORD Dot11extSetUnicastCipherAlgorithm(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           DWORD dwUnicastCipherAlgo
)
{...}

参数

[in, optional] hDot11SvcHandle

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

[in] dwUnicastCipherAlgo

标识单播密码算法 的DOT11_CIPHER_ALGORITHM 枚举器值。

如果值在 通过 DOT11_CIPHER_ALGO_IHV_END 的DOT11_CIPHER_ALGO_IHV_START 范围内,则 IHV 扩展 DLL 将启用 WLAN 适配器支持的专有密码算法。

否则,DLL 负责处理操作系统支持的标准密码算法。 在这种情况下,操作系统不涉及密码算法的任何方面,包括密钥管理和重播保护,通过基本服务集通过 WLAN 适配器 (BSS) 网络连接。

注意dwUnicastCipherAlgo 的值必须与 Native 802.11 微型端口驱动程序通过设置DOT11_EXTSTA_ATTRIBUTES结构的相应 xxxAlgoPairs 成员返回的密码算法的值匹配,该成员必须与查询 OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIROID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR 返回的值匹配。

返回值

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

要求

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

另请参阅

OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_CIPHER_ALGORITHM

Dot11ExtIhvInitAdapter