DOT11EXT_SET_VIRTUAL_STATION_AP_PROPERTIES回调函数 (wlanihv.h)

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

IHV 扩展 DLL 调用 Dot11ExtSetVirtualStationAPProperties 函数来指定当前的 IHV 配置文件连接。

语法

DOT11EXT_SET_VIRTUAL_STATION_AP_PROPERTIES Dot11extSetVirtualStationApProperties;

DWORD Dot11extSetVirtualStationApProperties(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwNumProperties,
  [in]           PDOT11EXT_VIRTUAL_STATION_AP_PROPERTY pProperties,
                 LPVOID pvReserved
)
{...}

参数

[in, optional] hDot11SvcHandle

作系统用于引用主要物理无线 LAN (WLAN) 适配器的可选句柄。 此句柄值是通过上一次调用 Dot11ExtIhvInitAdapter IHV 处理程序函数接收为 hDot11SvcHandle 参数。

[in, optional] hConnectSession

作系统用来引用当前连接会话与基本服务集 (BSS) 网络的句柄。 此句柄值是通过上一次调用 hConnectSession 参数接收的 Dot11ExtIhvPerformPreAssociate IHV 处理程序函数。

[in] dwNumProperties

pProperties 参数指向的结构数组中的元素数。

[in] pProperties

指向 数组的指针 DOT11EXT_VIRTUAL_STATION_AP_PROPERTY 结构,用于指定虚拟 802.11 工作站尝试在当前连接会话中托管的接入点(AP)的属性。

pvReserved

此参数保留供作系统使用,应 NULL

返回值

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

言论

如果当前的 IHV 配置文件连接是一个接入点(AP),并且 IHV 扩展 DLL 可以向作系统提供 AP 所使用的设置,则作系统可以向从作系统请求 AP 相关服务的用户提供其他信息。

如果 IHV 扩展 DLL 调用 Dot11ExtSetVirtualStationAPProperties,则必须在调用 Dot11ExtIhvPerformPreAssociate IHV 处理程序函数。 如果在成功完成关联作之前未调用 Dot11ExtSetVirtualStationAPProperties,则作系统不会对 IHV 配置文件的性质做出任何假设。

要求

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

另请参阅

Dot11ExtIhvPerformPreAssociate

Dot11ExtIhvInitAdapter

DOT11EXT_VIRTUAL_STATION_AP_PROPERTY