wlanhostedNetworkInitSettings 函数 (wlanapi.h)
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。
如果函数失败，则返回值可能是以下返回代码之一。
| 返回代码 | 说明 |
|---|---|
|
句柄无效。 如果在句柄表中找不到 hClientHandle 参数中指定的句柄，则返回此错误。 |
|
参数不正确。 如果出现以下任一情况，则返回此错误：
|
|
资源未处于正确的状态，无法执行请求的操作。 |
|
该服务尚未启动。 如果 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 |
另请参阅
WlanHostedNetworkQueryProperty
WlanHostedNetworkQuerySecondaryKey
WlanHostedNetworkRefreshSecuritySettings