WlanConnect-Funktion (wlanapi.h)

  • Artikel

Die WlanConnect-Funktion versucht, eine Verbindung mit einem bestimmten Netzwerk herzustellen.

Syntax

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

Parameter

[in] hClientHandle

Das Sitzungshandle des Clients, das von einem vorherigen Aufruf der WlanOpenHandle-Funktion zurückgegeben wurde.

[in] pInterfaceGuid

Die GUID der Schnittstelle, die für die Verbindung verwendet werden soll.

[in] pConnectionParameters

Zeiger auf eine WLAN_CONNECTION_PARAMETERS-Struktur , die den Verbindungstyp, den Modus, das Netzwerkprofil, die SSID zum Identifizieren des Netzwerks und andere Parameter angibt.

Windows XP mit SP3 und WLAN-API für Windows XP mit SP2: Es gibt einige Einschränkungen für die WLAN_CONNECTION_PARAMETERS-Member . Dies bedeutet, dass Strukturen, die für Windows Server 2008 und Windows Vista gültig sind, möglicherweise nicht für Windows XP mit SP3 oder die WLAN-API für Windows XP mit SP2 gültig sind. Eine Liste der Einschränkungen finden Sie unter WLAN_CONNECTION_PARAMETERS.

pReserved

Für die zukünftige Verwendung reserviert. Muss auf NULL festgelegt werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Rückgabecodes sein.

Rückgabecode Beschreibung
ERROR_INVALID_PARAMETER
 Eine der folgenden Bedingungen ist aufgetreten:
  • hClientHandle ist NULL oder ungültig.
  • pInterfaceGuid ist NULL.
  • pConnectionParameters ist NULL.
  • Das dwFlags-Element der Struktur, auf die von pConnectionParameters verwiesen wird, ist nicht auf einen der auf der seite WLAN_CONNECTION_PARAMETERS angegebenen Werte festgelegt.
  • Das wlanConnectionMode-Element der Struktur, auf die von pConnectionParameters verwiesen wird, ist auf wlan_connection_mode_discovery_secure oder wlan_connection_mode_discovery_unsecure festgelegt, und das pDot11Ssid-Element derselben Struktur ist NULL.
  • Das wlanConnectionMode-Element der Struktur, auf die von pConnectionParameters verwiesen wird, ist auf wlan_connection_mode_discovery_secure oder wlan_connection_mode_discovery_unsecure festgelegt, und das dot11BssType-Element derselben Struktur ist auf dot11_BSS_type_any festgelegt.
  • Das wlanConnectionMode-Element der Struktur, auf die von pConnectionParameters verwiesen wird, ist auf wlan_connection_mode_profile festgelegt, und das strProfile-Element derselben Struktur ist NULL , oder die Länge des Profils überschreitet WLAN_MAX_NAME_LENGTH.
  • Das wlanConnectionMode-Element der Struktur, auf die von pConnectionParameters verwiesen wird, ist auf wlan_connection_mode_profile festgelegt, und das strProfile-Element derselben Struktur ist NULL oder die Länge des Profils ist 0.
  • Das wlanConnectionMode-Element der Struktur, auf die von pConnectionParameters verwiesen wird, ist auf wlan_connection_mode_invalid oder wlan_connection_mode_auto festgelegt.
  • Das dot11BssType-Element der Struktur, auf die von pConnectionParameters verwiesen wird, ist auf dot11_BSS_type_infrastructure festgelegt, und das dwFlags-Element derselben Struktur ist auf WLAN_CONNECTION_ADHOC_JOIN_ONLY festgelegt.
  • Das dot11BssType-Element der Struktur, auf die von pConnectionParameters verwiesen wird, ist auf dot11_BSS_type_independent festgelegt, und das dwFlags-Element derselben Struktur ist auf WLAN_CONNECTION_HIDDEN_NETWORK festgelegt.
  • Das dwFlags-Element der Struktur, auf die von pConnectionParameters verwiesen wird, ist auf WLAN_CONNECTION_IGNORE_PRIVACY_BIT festgelegt, und entweder ist das wlanConnectionMode-Element derselben Struktur nicht auf wlan_connection_mode_temporary_profile oder das dot11BssType-Element derselben Struktur auf dot11_BSS_type_independent festgelegt.
ERROR_INVALID_HANDLE
 Das Handle hClientHandle wurde in der Handle-Tabelle nicht gefunden.
RPC_STATUS
 Verschiedene Fehlercodes.
ERROR_ACCESS_DENIED
 Der Aufrufer verfügt nicht über ausreichende Berechtigungen.

Hinweise

Die WlanConnect-Funktion wird sofort zurückgegeben. Um benachrichtigt zu werden, wenn eine Verbindung hergestellt wird oder keine weiteren Verbindungen hergestellt werden, muss sich ein Client für Benachrichtigungen registrieren, indem er WlanRegisterNotification aufruft.

Das strProfile-Element der WLAN_CONNECTION_PARAMETERS Struktur, auf die von pConnectionParameters verwiesen wird, gibt das Profil an, das für die Verbindung verwendet werden soll. Wenn es sich bei diesem Profil um ein Benutzerprofil handelt, muss der WlanConnect-Aufrufer über Ausführungszugriff auf das Profil verfügen. Andernfalls schlägt der WlanConnect-Aufruf mit dem Rückgabewert ERROR_ACCESS_DENIED fehl. Die Berechtigungen für ein Benutzerprofil werden eingerichtet, wenn das Profil mithilfe von WlanSetProfile oder WlanSaveTemporaryProfile erstellt oder gespeichert wird.

Verwenden Sie den Befehl netsh wlan connect , um einen Verbindungsvorgang an der Befehlszeile auszuführen. Weitere Informationen finden Sie unter Netsh Commands for Wireless Local Area Network (WLAN).

Windows XP mit SP3 und WLAN-API für Windows XP mit SP2: Sie können wlanConnect nur verwenden, um eine Verbindung mit Netzwerken in der bevorzugten Netzwerkliste herzustellen. Um der bevorzugten Netzwerkliste ein Netzwerk hinzuzufügen, rufen Sie WlanSetProfile auf.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista, Windows XP mit SP3 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wlanapi.h (einschließlich Wlanapi.h)
Bibliothek Wlanapi.lib
DLL Wlanapi.dll
Verteilbare Komponente Wlan-API für Windows XP mit SP2

Weitere Informationen

WLAN_CONNECTION_PARAMETERS

WlanDisconnect