wlanConnect 函式 (wlanapi.h)

WlanConnect函式會嘗試連線到特定網路。

語法

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

參數

[in] hClientHandle

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

[in] pInterfaceGuid

要用於連線之介面的 GUID。

[in] pConnectionParameters

WLAN_CONNECTION_PARAMETERS結構的指標，指定可識別網路和其他參數的連線類型、模式、網路設定檔、SSID。

Windows XP 搭配 SP3 和適用于 Windows XP 的無線區域網路 API 與 SP2：WLAN_CONNECTION_PARAMETERS成員有一些條件約束。 這表示對於 Windows Server 2008 和 Windows Vista 有效的結構可能不適用於具有 SP3 的 Windows XP，或 Windows XP SP2 的無線區域網路 API。 如需條件約束的清單，請參閱 WLAN_CONNECTION_PARAMETERS。

pReserved

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

傳回值

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

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

傳回碼	描述
ERROR_INVALID_PARAMETER	發生下列其中一個條件： hClientHandle 為 Null 或無效。 pInterfaceGuid 為 Null。 pConnectionParameters 為 Null。 pConnectionParameters所指向結構的dwFlags成員不會設定為WLAN_CONNECTION_PARAMETERS頁面上指定的其中一個值。 pConnectionParameters指向之結構的wlanConnectionMode成員會設定為wlan_connection_mode_discovery_secure或wlan_connection_mode_discovery_unsecure，而相同結構的pDot11Ssid成員為Null。 pConnectionParameters所指向結構的wlanConnectionMode成員會設定為wlan_connection_mode_discovery_secure或wlan_connection_mode_discovery_unsecure，而相同結構的dot11BssType成員會設定為dot11_BSS_type_any。 pConnectionParameters所指向結構的wlanConnectionMode成員會設定為wlan_connection_mode_profile，而相同結構的strProfile成員為Null，或設定檔的長度超過WLAN_MAX_NAME_LENGTH。 pConnectionParameters所指向之結構的wlanConnectionMode成員會設定為wlan_connection_mode_profile，而相同結構的strProfile成員為Null或設定檔的長度為零。 pConnectionParameters所指向結構的wlanConnectionMode成員會設定為wlan_connection_mode_invalid或wlan_connection_mode_auto。 pConnectionParameters所指向結構的dot11BssType成員會設定為dot11_BSS_type_infrastructure，而相同結構的dwFlags成員會設定為WLAN_CONNECTION_ADHOC_JOIN_ONLY。 pConnectionParameters所指向結構的dot11BssType成員會設定為dot11_BSS_type_independent，而相同結構的dwFlags成員會設定為WLAN_CONNECTION_HIDDEN_NETWORK。 pConnectionParameters所指向結構的dwFlags成員會設定為WLAN_CONNECTION_IGNORE_PRIVACY_BIT，而且相同結構的wlanConnectionMode成員未設定為wlan_connection_mode_temporary_profile，或相同結構的dot11BssType成員設定為dot11_BSS_type_independent。
ERROR_INVALID_HANDLE	控制碼資料表中找不到控制碼 hClientHandle 。
RPC_STATUS	各種錯誤碼。
ERROR_ACCESS_DENIED	呼叫端沒有足夠的許可權。

備註

WlanConnect函式會立即傳回。 若要在建立連線或未嘗試進一步連線時收到通知，用戶端必須呼叫 WlanRegisterNotification來註冊通知。

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

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

Windows XP 搭配 SP3 和適用于 Windows XP 的無線區域網路 API 與 SP2： 您只能使用 WlanConnect 連線到慣用網路清單上的網路。 若要將網路新增至慣用的網路清單，請呼叫 WlanSetProfile。

規格需求

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

另請參閱

WLAN_CONNECTION_PARAMETERS

WlanDisconnect