wlanRegisterVirtualStationNotification 函数 (wlanapi.h)

  • 项目

WlanRegisterVirtualStationNotification 函数用于在虚拟工作站上注册和取消注册通知。

语法

DWORD WlanRegisterVirtualStationNotification(
  [in] HANDLE hClientHandle,
  [in] BOOL   bRegister,
       PVOID  pReserved
);

参数

[in] hClientHandle

客户端的会话句柄，由上一次对 WlanOpenHandle 函数的调用获取。

[in] bRegister

一个 值，该值指定是否在虚拟工作站上接收通知。

pReserved

保留供将来使用。 此参数必须为 NULL。

返回值

如果函数成功，则返回值为 ERROR_SUCCESS。

如果函数失败，则返回值可能是以下返回代码之一。

返回代码 说明
ERROR_INVALID_PARAMETER
 参数不正确。 如果出现以下任一情况，将返回此错误：
  • hClientHandle 为 NULL。
  • pvReserved 不为 NULL。
ERROR_INVALID_HANDLE
 句柄无效。 如果在句柄表中找不到 hClientHandle 参数中指定的句柄，则返回此错误。
ERROR_INVALID_STATE
 资源未处于执行所请求操作的正确状态。 如果域上的组策略禁用了无线托管网络，则返回此错误。
ERROR_SERVICE_NOT_ACTIVE
 该服务尚未启动。 如果 WLAN 自动配置服务未运行，则返回此错误。
其他
 各种 RPC 和其他错误代码。 使用 FormatMessage 获取返回错误的消息字符串。

注解

WlanRegisterVirtualStationNotification 函数是添加到本机无线 API 的扩展，支持安装了无线 LAN 服务的 Windows 7 和 Windows Server 2008 R2 上的无线托管网络。

调用 WlanRegisterVirtualStationNotification 函数的客户端应用程序用于在虚拟工作站上注册和取消注册通知。

如果调用应用程序通过使用 hClientHandle 参数) 调用 WlanCloseHandle 关闭其调用句柄 (，或者如果进程结束，则会自动撤消从此函数引起的从虚拟工作站接收通知的任何注册。

默认情况下，应用程序客户端不会在虚拟工作站上收到通知。 为了接收这些通知，客户端需要调用将 bRegister 参数设置为 TRUE 的 WlanRegisterVirtualStationNotification 函数，并且还必须调用 WlanRegisterNotification 函数，并将 dwNotifSource 参数设置为要注册的通知源。 从虚拟工作站接收通知的注册将生效，直到应用程序通过使用 hClientHandle 参数调用 WlanCloseHandle 关闭客户端句柄) (，进程结束，或者调用 WlanRegisterVirtualStationNotification 函数，并将 bRegister 参数设置为 FALSE。

在 Windows 7 及更高版本上，如果计算机上存在支持托管网络的无线适配器，则操作系统将安装虚拟设备。 如果计算机具有单个无线网络适配器，此虚拟设备通常会在“网络连接文件夹”中显示为“无线网络连接 2”，设备名称为“Microsoft 虚拟 WiFi 微型端口适配器”。 此虚拟设备专门用于执行软接入点 (SoftAP) 连接，并且不存在于 WlanEnumInterfaces 函数返回的列表中。 此虚拟设备的生存期与物理无线适配器相关联。 如果物理无线适配器处于禁用状态，此虚拟设备也将被删除。 此功能在安装了无线 LAN 服务的 Windows Server 2008 R2 上也可用。

要求

   
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 wlanapi.h (包括 Wlanapi.h)
Library Wlanapi.lib
DLL Wlanapi.dll

另请参阅

关于无线托管网络

使用无线托管网络和 Internet 连接共享

WlanCloseHandle

WlanRegisterNotification