WlanHostedNetworkInitSettings 函式 (wlanapi.h)

發行項
03/09/2024

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。

如果函式失敗，傳回值可能是下列其中一個傳回碼。

傳回碼	Description
ERROR_INVALID_HANDLE	句柄無效。如果在句柄數據表中找不到 hClientHandle 參數中指定的句柄，就會傳回此錯誤。
ERROR_INVALID_PARAMETER	參數不正確。如果發生下列任一狀況，就會傳回此錯誤： hClientHandle 為 NULL。 pvReserved 不是 NULL。
ERROR_INVALID_STATE	資源未處於執行要求作業的正確狀態。
ERROR_SERVICE_NOT_ACTIVE	尚未啟動服務。如果WLAN自動設定服務未執行，則會傳回此錯誤。
其他	各種 RPC 和其他錯誤碼。使用 FormatMessage 取得傳回錯誤的訊息字串。

備註

WlanHostedNetworkInitSettings 函式是新增的原生無線 API 擴充功能，可支援 Windows 7 和 Windows Server 2008 R2 上安裝無線 LAN 服務的無線託管網路。

用戶端應用程式會呼叫 WlanHostedNetworkInitSettings 函式，以在尚未設定連線設定的情況下，將網路連線設定 (SSID 和對等數目上限，例如) 無線網路上的連線設定。如果無線託管網路設定上的網路設定已經設定 (WlanHostedNetworkQueryProperty 函式不會針對月臺配置檔或連線設定) 傳回 ERROR_BAD_CONFIGURATION ，則此函數調用會傳回 ERROR_SUCCESS 而不變更網路連線設定的組態。

用戶端應用程式應該一律呼叫 WlanHostedNetworkInitSettings 函式，再使用本機電腦上的其他託管網路功能。此函式會初始化本機計算機上第一次使用無線託管網路時所需的設定。 WlanHostedNetworkInitSettings 函式不會在設定已保存時變更任何設定。因此，如果已保存設定， 則呼叫 WlanHostedNetworkInitSettings 函 式是安全的。建議您在使用其他託管網路功能之前，使用託管網路的應用程式先呼叫 WlanHostedNetworkInitSettings 函式。

WlanHostedNetworkInitSettings 函式會從主機名計算隨機且可讀取的 SSID，並計算隨機的主鍵。此函式也會針對預設為100的對等數目上限設定值。如果應用程式想要使用不同的 SSID 或不同的對等數目上限，則應用程式應該呼叫 WlanHostedNetworkSetProperty 函式來特別設定無線託管網路所使用的這些屬性。

如果呼叫應用程式使用 hClientHandle 參數呼叫 WlanCloseHandle (，) 或進程結束時，呼叫 WlanCloseHandle，則不會自動復原此函式所造成的任何裝載網路狀態變更。

任何使用者都可以呼叫 WlanHostedNetworkInitSettings 函式，以設定並保存到託管網路上的記憶體網路連線設定。如果已設定無線裝載網路，此函式不會執行任何動作，並傳回 ERROR_SUCCESS。

在 Windows 7 和更新版本上，如果電腦上存在支援託管網路的無線適配卡，操作系統就會安裝虛擬設備。如果計算機具有單一無線網路適配卡，此虛擬設備通常會顯示在「網路 Connections 資料夾」中顯示為「無線網路連線 2」，且裝置名稱為「Microsoft Virtual WiFi Miniport 配接器」。此虛擬設備專門用來執行軟體存取點 (SoftAP) 連線，而且不會出現在 WlanEnumInterfaces 函式所傳回的清單中。此虛擬設備的存留期會系結至實體無線適配卡。如果實體無線適配卡已停用，也會移除此虛擬設備。此功能也適用於已安裝無線 LAN 服務的 Windows Server 2008 R2。

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限桌面應用程式]
目標平台	Windows
標頭	wlanapi.h (包含 Wlanapi.h)
程式庫	Wlanapi.lib
Dll	Wlanapi.dll