WlanCloseHandle-Funktion (wlanapi.h)
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 |
|---|---|
|
hClientHandle ist NULL oder ungültig, oder pReserved ist nicht NULL. |
|
Das Handle hClientHandle wurde in der Handletabelle nicht gefunden. |
|
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 |