(wlanihv.h) 的DOT11EXT_SET_MULTICAST_CIPHER_ALGORITHM回调函数

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

IHV 扩展 DLL 调用 Dot11ExtSetMulticastCipherAlgorithm 函数，以在无线 LAN (WLAN) 适配器上启用多播密码算法。

语法

DOT11EXT_SET_MULTICAST_CIPHER_ALGORITHM Dot11extSetMulticastCipherAlgorithm;

DWORD Dot11extSetMulticastCipherAlgorithm(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           DWORD dwMulticastCipherAlgo
)
{...}

参数

[in, optional] hDot11SvcHandle

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

[in] dwMulticastCipherAlgo

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

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

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

注意dwMulticastCipherAlgo 的值必须与 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)

另请参阅

OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_CIPHER_ALGORITHM

Dot11ExtIhvInitAdapter