WlanHostedNetworkForceStart 函式 (wlanapi.h)

發行項
08/28/2023

WlanHostedNetworkForceStart函式會將無線託管網路轉換為wlan_hosted_network_active狀態，而不需要將要求與應用程式的呼叫控制碼產生關聯。

語法

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

參數

[in] hClientHandle

用戶端的會話控制碼，由先前呼叫 WlanOpenHandle 函式所傳回。

[out, optional] pFailReason

如果 呼叫 WlanHostedNetworkForceStart 函式失敗，則為接收失敗原因之值的選擇性指標。失敗原因的可能值來自Wlanapi.h標頭檔中定義的WLAN_HOSTED_NETWORK_REASON列舉類型。

pvReserved

保留供未來使用。此參數必須是 Null。

傳回值

如果函式成功，傳回值會ERROR_SUCCESS。

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

傳回碼	描述
ERROR_ACCESS_DENIED	呼叫端沒有足夠的許可權。
ERROR_INVALID_HANDLE	控制碼無效。如果在控制碼資料表中找不到 hClientHandle 參數中指定的控制碼，就會傳回此錯誤。
ERROR_INVALID_PARAMETER	參數不正確。如果發生下列任一狀況，就會傳回此錯誤： hClientHandle 為 Null。 pvReserved 不是 Null。
ERROR_INVALID_STATE	資源未處於執行要求作業的正確狀態。如果網域上的群組原則停用無線託管網路，就會傳回此錯誤。
ERROR_SERVICE_NOT_ACTIVE	尚未啟動服務。如果 WLAN 自動設定服務未執行，則會傳回此錯誤。
其他	各種 RPC 和其他錯誤碼。使用 FormatMessage 取得傳回錯誤的訊息字串。

備註

WlanHostedNetworkForceStart函式是新增的原生無線 API 延伸模組，可支援 Windows 7 和 Windows Server 2008 R2 上安裝無線區域網路服務的無線託管網路。

用戶端應用程式會呼叫 WlanHostedNetworkForceStart 函式，藉由將無線託管網路轉換為 wlan_hosted_network_active狀態 來強制啟動無線託管網路，而不需將要求與應用程式的呼叫控制碼產生關聯。 對 WlanHostedNetworkForceStart函式的成功呼叫最終應該與WlanHostedNetworkForceStop函式的呼叫相符。如果呼叫應用程式使用hClientHandle參數呼叫 WlanCloseHandle (，) 或進程結束時，呼叫WlanCloseHandle，則不會自動復原此函式所造成的任何裝載網路狀態變更。

透過呼叫WlanHostedNetworkStartStartUsing來呼叫WlanHostedNetworkForceStart 函式的成本是所需的相關聯許可權。應用程式可能會在確保提升許可權的系統使用者接受長時間執行無線託管網路時涉及增加的電源需求之後，呼叫 WlanHostedNetworkForceStart 函式。

如果裝載的網路狀態wlan_hosted_network_unavailable或呼叫端沒有足夠的許可權，WlanHostedNetworkForceStart函式可能會失敗。

只有在使用者具有適當的相關聯許可權時，才能呼叫此函式來強制啟動託管網路。許可權會儲存在與 WLAN_SECURABLE_OBJECT相關聯的 DACL) (任意存取控制清單中。若要呼叫 WlanHostedNetworkForceStart，呼叫者的用戶端存取權杖必須具有下列列舉所公開的許可權， WLAN_SECURABLE_OBJECT：

wlan_secure_hosted_network_elevated_access

啟用無線託管網路的能力也可能受限於網域中的群組原則。

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

規格需求


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