WlanDisconnect-Funktion (wlanapi.h)

  • Artikel

Die WlanDisconnect-Funktion trennt eine Schnittstelle vom aktuellen Netzwerk.

Syntax

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

Parameter

[in] hClientHandle

Das Sitzungshandle des Clients, das durch einen vorherigen Aufruf der WlanOpenHandle-Funktion abgerufen wurde.

[in] pInterfaceGuid

Die GUID der zu trennenden Schnittstelle.

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
 hClientHandle ist NULL oder ungültig, pInterfaceGuid ist NULL oder pReserved ist nicht NULL.
ERROR_INVALID_HANDLE
 Das Handle hClientHandle wurde in der Handle-Tabelle nicht gefunden.
RPC_STATUS
 Verschiedene Fehlercodes.
ERROR_NOT_ENOUGH_MEMORY
 Fehler beim Zuweisen von Arbeitsspeicher für die Abfrageergebnisse.
ERROR_ACCESS_DENIED
 Der Aufrufer verfügt nicht über ausreichende Berechtigungen.

Hinweise

Als die Verbindung mithilfe von WlanConnect hergestellt wurde, wurde ein Profil vom strProfile-Element der WLAN_CONNECTION_PARAMETERS Struktur angegeben, auf die pConnectionParameters verweist. Wenn es sich bei diesem Profil um ein Benutzerprofil handelt, muss der WlanDisconnect-Aufrufer über Ausführungszugriff auf das Profil verfügen. Andernfalls schlägt der WlanDisconnect-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 disconnect , 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-LAN-API für Windows XP mit SP2: WlanDisconnect hat den Nebeneffekt, dass das Profil geändert wird, das dem getrennten Netzwerk zugeordnet ist. Ein Netzwerkprofil wird nach einem WlanDisconnect-Anruf zu einem Bedarfsprofil. Der Wireless Zero Configuration-Dienst stellt nicht automatisch eine Verbindung mit einem Netzwerk mit einem Bedarfsprofil her, wenn sich das Netzwerk in Reichweite befindet. Rufen Sie WlanDisconnect nicht auf, bevor Sie WlanConnect aufrufen, es sei denn, Sie möchten ein Profil in ein On-Demand-Profil ändern. Wenn Sie WlanConnect aufrufen, um eine Netzwerkverbindung herzustellen, wird jede vorhandene Netzwerkverbindung automatisch gelöscht.

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

WlanConnect