Funzione WlanCloseHandle (wlanapi.h)
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 |
---|---|
|
hClientHandle è NULL o non valido oppure pReserved non è NULL. |
|
L'handle hClientHandle non è stato trovato nella tabella handle. |
|
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 |