共用方式為

wlanDisconnect 函式 (wlanapi.h)

  • 發行項

WlanDisconnect函式會中斷介面與其目前網路的連線。

語法

DWORD WlanDisconnect(
  [in] HANDLE     hClientHandle,
  [in] const GUID *pInterfaceGuid,
       PVOID      pReserved
);

參數

[in] hClientHandle

用戶端的會話控制碼，由先前呼叫 WlanOpenHandle 函式取得。

[in] pInterfaceGuid

要中斷連線之介面的 GUID。

pReserved

保留供未來使用。 必須設定為 Null。

傳回值

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

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

傳回碼 描述
ERROR_INVALID_PARAMETER
 hClientHandle 為 Null 或無效， pInterfaceGuid 為 Null，或 pReserved 不是 Null。
ERROR_INVALID_HANDLE
 控制碼資料表中找不到控制碼 hClientHandle 。
RPC_STATUS
 各種錯誤碼。
ERROR_NOT_ENOUGH_MEMORY
 無法為查詢結果配置記憶體。
ERROR_ACCESS_DENIED
 呼叫端沒有足夠的許可權。

備註

使用WlanConnect建立連線時，設定檔是由pConnectionParameters所指向之WLAN_CONNECTION_PARAMETERS結構的strProfile成員所指定。 如果該設定檔是所有使用者設定檔， WlanDisconnect 呼叫端必須在設定檔上擁有執行存取權。 否則 ，WlanDisconnect 呼叫將會失敗，且傳回值ERROR_ACCESS_DENIED。 使用 WlanSetProfile 或 WlanSaveTemporaryProfile建立或儲存設定檔時，會建立所有使用者設定檔的許可權。

若要在命令列執行中斷連線作業，請使用 netsh wlan disconnect 命令。 如需詳細資訊，請參閱 無線區域網路的 Netsh 命令 (wlan) 。

Windows XP 搭配 SP2 的 SP3 和無線區域網路 API： WlanDisconnect 具有修改與中斷連線網路相關聯之設定檔的副作用。 網路設定檔會在 WlanDisconnect 呼叫之後變成隨選設定檔。 當網路位於範圍內時，無線零組態服務將不會自動連線到具有隨選設定檔的網路。 除非您想要將設定檔變更為隨選設定檔，否則請勿在呼叫WlanConnect之前呼叫WlanDisconnect。 當您呼叫 WlanConnect 以建立網路連線時，會自動卸載任何現有的網路連線。

規格需求

   
最低支援的用戶端 Windows Vista、Windows XP 與 SP3 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 wlanapi.h (包含 Wlanapi.h)
程式庫 Wlanapi.lib
Dll Wlanapi.dll
可轉散發套件 適用于 Windows XP 與 SP2 的無線區域網路 API

另請參閱

WlanConnect