wlanHostedNetworkStopUsing 函数 (wlanapi.h)

WlanHostedNetworkStopUsing 函数停止无线托管网络。

语法

DWORD WlanHostedNetworkStopUsing(
  [in]            HANDLE                      hClientHandle,
  [out, optional] PWLAN_HOSTED_NETWORK_REASON pFailReason,
                  PVOID                       pvReserved
);

参数

[in] hClientHandle

客户端的会话句柄,由上一次对 WlanOpenHandle 函数的调用返回。

[out, optional] pFailReason

一个可选指针,该值在对 WlanHostedNetworkStopUsing 函数的调用失败时接收失败原因。 失败原因的可能值来自 wlanapi.h 头文件中定义的 WLAN_HOSTED_NETWORK_REASON 枚举类型。

pvReserved

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

返回值

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

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

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

注解

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

应用程序调用 WlanHostedNetworkStopUsing 函数来停止托管网络。 应用程序调用 WlanHostedNetworkStopUsing 函数,以匹配对 WlanHostedNetworkStartUsing 函数的早期成功调用。 无线托管网络将保持活动状态,直到所有应用程序都调用 WlanHostedNetworkStopUsing 函数或 调用 WlanHostedNetworkForceStop 函数来强制停止。 当无线托管网络停止时,状态将切换到 wlan_hosted_network_idle。 如果由于外部事件 ((例如,无线接口卡的微型端口驱动程序) 不可用),则此调用也可能失败。

任何用户都可以调用此函数来停止托管网络。 但是,启用无线托管网络的能力可能会受到域中的组策略的限制。

在 Windows 7 及更高版本上,如果计算机上存在支持托管网络的无线适配器,则操作系统将安装虚拟设备。 如果计算机具有单个无线网络适配器,此虚拟设备通常显示在“网络Connections文件夹中”显示为“无线网络连接 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 连接共享

WLAN_HOSTED_NETWORK_REASON

WlanCloseHandle

WlanEnumInterfaces

WlanHostedNetworkForceStart

WlanHostedNetworkForceStop

WlanHostedNetworkQueryStatus

WlanHostedNetworkStartUsing

WlanOpenHandle