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_PAIR 或 OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR 返回的值匹配。
返回值
如果调用成功，函数将返回ERROR_SUCCESS。 否则，它将返回 Winerror.h 中定义的错误代码。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Windows Vista 和更高版本的 Windows 操作系统中可用。 |
| 目标平台 | 桌面 |
| 标头 | wlanihv.h (包括 Wlanihv.h) |