wlanhostedNetworkInitSettings 函数 (wlanapi.h)

项目
08/28/2023

WlanHostedNetworkInitSettings 函数配置并持久存储网络连接设置 (SSID 和最大对等数，例如，如果尚未配置这些设置，则) 无线托管网络上。

语法

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

参数

[in] hClientHandle

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

[out, optional] pFailReason

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

pvReserved

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

返回值

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

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

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

注解

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

客户端应用程序调用 WlanHostedNetworkInitSettings 函数来配置并保存网络连接设置 (SSID 和最大对等数，例如，如果尚未配置连接设置，则) 无线托管网络上。如果无线托管网络设置上的网络设置已配置 (WlanHostedNetworkQueryProperty 函数不返回工作站配置文件或连接设置) 的ERROR_BAD_CONFIGURATION，则此函数调用返回 ERROR_SUCCESS 而不更改网络连接设置的配置。

在在本地计算机上使用其他托管网络功能之前，客户端应用程序应始终调用 WlanHostedNetworkInitSettings 函数。此函数初始化在本地计算机上首次使用无线托管网络时所需的设置。如果已保留配置， WlanHostedNetworkInitSettings 函数不会更改任何配置。因此，如果配置已保留，则可以安全地调用 WlanHostedNetworkInitSettings 函数。建议使用托管网络的应用程序在使用其他托管网络功能之前调用 WlanHostedNetworkInitSettings 函数。

WlanHostedNetworkInitSettings 函数从主机名中计算随机且可读的 SSID，并计算随机主键。此函数还使用设置允许的最大对等数的值，默认值为 100。如果应用程序想要使用不同的 SSID 或不同的最大对等数，则应用程序应调用 WlanHostedNetworkSetProperty 函数来专门设置无线托管网络使用的这些属性。

如果调用应用程序通过使用 hClientHandle 参数) 调用 WlanCloseHandle 来关闭其调用句柄 (，或者进程结束，则此函数导致的任何托管网络状态更改都不会自动撤消。

任何用户都可以调用 WlanHostedNetworkInitSettings 函数来配置并保存到托管网络上的网络连接设置。如果已配置无线托管网络，则此函数不执行任何操作，并返回 ERROR_SUCCESS。

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