WlanCloseHandle-Funktion (wlanapi.h)

  • Artikel

Die WlanCloseHandle-Funktion schließt eine Verbindung mit dem Server.

Syntax

DWORD WlanCloseHandle(
  [in] HANDLE hClientHandle,
       PVOID  pReserved
);

Parameter

[in] hClientHandle

Das Sitzungshandle des Clients, das die verbindung identifiziert, die geschlossen werden soll. Dieses Handle wurde durch einen vorherigen Aufruf der WlanOpenHandle-Funktion abgerufen.

pReserved

Für die zukünftige Verwendung reserviert. Legen Sie diesen Parameter auf NULL fest.

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, oder pReserved ist nicht NULL.
ERROR_INVALID_HANDLE
 Das Handle hClientHandle wurde in der Handletabelle nicht gefunden.
RPC_STATUS
 Verschiedene Fehlercodes.

Hinweise

Nachdem eine Verbindung geschlossen wurde, kann jede versuchte Verwendung des geschlossenen Handle zu unerwarteten Fehlern führen. Nach dem Schließen werden alle ausstehenden Benachrichtigungen verworfen.

Rufen Sie WlanCloseHandle nicht über eine Rückruffunktion auf. Wenn sich der Client während des Aufrufs von WlanCloseHandle in der Mitte eines Benachrichtigungsrückrufs befindet, wartet die Funktion auf den Abschluss des Rückrufs, bevor sie einen Wert zurückgibt. Das Aufrufen dieser Funktion innerhalb einer Rückruffunktion führt dazu, dass der Aufruf nie abgeschlossen wird. Wenn sowohl die Rückruffunktion als auch der Thread, der das Handle schließt, versuchen, dieselbe Sperre zu erhalten, kann ein Deadlock auftreten. Rufen Sie außerdem WlanCloseHandle nicht über die DllMain-Funktion in einer Anwendungs-DLL auf. Dies kann auch zu einem Deadlock führen.

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 (wlanapi.h einschließen)
Bibliothek Wlanapi.lib
DLL Wlanapi.dll
Verteilbare Komponente Wlan-API für Windows XP mit SP2

Weitere Informationen

WlanOpenHandle