Funzione WlanCloseHandle (wlanapi.h)

Articolo
03/15/2023

La funzione WlanCloseHandle chiude una connessione al server.

Sintassi

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

Parametri

[in] hClientHandle

Handle di sessione del client, che identifica la connessione da chiudere. Questo handle è stato ottenuto da una chiamata precedente alla funzione WlanOpenHandle .

pReserved

Riservato per utilizzi futuri. Impostare questo parametro su NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito può essere uno dei codici restituiti seguenti.

Codice restituito	Descrizione
ERROR_INVALID_PARAMETER	hClientHandle è NULL o non valido oppure pReserved non è NULL.
ERROR_INVALID_HANDLE	L'handle hClientHandle non è stato trovato nella tabella handle.
RPC_STATUS	Vari codici di errore.

Commenti

Dopo la chiusura di una connessione, qualsiasi tentativo di utilizzo dell'handle chiuso può causare errori imprevisti. Al termine, tutte le notifiche in sospeso vengono eliminate.

Non chiamare WlanCloseHandle da una funzione di callback. Se il client si trova al centro di un callback di notifica quando viene chiamato WlanCloseHandle , la funzione attende il completamento del callback prima di restituire un valore. Se si chiama questa funzione all'interno di una funzione di callback, la chiamata non viene mai completata. Se sia la funzione di callback che il thread che chiude l'handle tentano di acquisire lo stesso blocco, può verificarsi un deadlock. Inoltre, non chiamare WlanCloseHandle dalla funzione DllMain in una DLL dell'applicazione. Questo potrebbe anche causare un deadlock.

Requisiti


Client minimo supportato	Windows Vista, Windows XP con SP3 [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wlanapi.h (include Wlanapi.h)
Libreria	Wlanapi.lib
DLL	Wlanapi.dll
Componente ridistribuibile	API LAN wireless per Windows XP con SP2

Vedi anche

WlanOpenHandle

Condividi tramite