WlanHostedNetworkStartUsing 函式 (wlanapi.h)
WlanHostedNetworkStartUsing 函式會啟動無線託管網路。
語法
DWORD WlanHostedNetworkStartUsing(
[in] HANDLE hClientHandle,
[out, optional] PWLAN_HOSTED_NETWORK_REASON pFailReason,
PVOID pvReserved
);
參數
[in] hClientHandle
用戶端的會話句柄，由先前呼叫 WlanOpenHandle 函式所傳回。
[out, optional] pFailReason
如果 WlanHostedNetworkStartUsing 函式的呼叫失敗，則為接收失敗原因之值的選擇性指標。 失敗原因的可能值來自 Wlanapi.h 頭檔中定義的WLAN_HOSTED_NETWORK_REASON列舉類型。
pvReserved
保留供未來使用。 此參數必須是 NULL。
傳回值
如果函式成功，傳回值會ERROR_SUCCESS。
如果函式失敗，傳回值可能是下列其中一個傳回碼。
| 傳回碼 | Description |
|---|---|
|
參數不正確。 如果發生下列任一狀況，就會傳回此錯誤：
|
|
句柄無效。 如果在句柄數據表中找不到 hClientHandle 參數中指定的句柄，就會傳回此錯誤。 |
|
資源未處於執行要求作業的正確狀態。 如果網域上的組策略停用無線託管網路，就會傳回此錯誤。 |
|
尚未啟動服務。 如果WLAN自動設定服務未執行，則會傳回此錯誤。 |
|
各種 RPC 和其他錯誤碼。 使用 FormatMessage 取得傳回錯誤的訊息字串。 |
備註
WlanHostedNetworkStartUsing 函式是新增的原生無線 API 擴充功能，可支援 Windows 7 和 Windows Server 2008 R2 上安裝無線 LAN 服務的無線託管網路。
用戶端應用程式會呼叫 WlanHostedNetworkStartUsing 函式來啟動無線託管網路。 呼叫 WlanHostedNetworkStopUsing 函 式必須比對成功呼叫。 如果裝載的網路狀態 wlan_hosted_network_unavailable，此呼叫可能會失敗。
如果呼叫應用程式使用 hClientHandle) 參數呼叫 WlanCloseHandle，或進程結束，則此函式所造成的任何裝載網路狀態變更都會自動復原 (。
任何使用者都可以呼叫 WlanHostedNetworkStartUsing 函式來啟動託管網路。 不過，啟用無線託管網路的能力可能會受限於網域中的組策略。
在 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 |