Funzione WFDCloseSession (wlanapi.h)
La funzione WFDCloseSession chiude una sessione dopo una chiamata riuscita in precedenza alla funzione WFDStartOpenSession .
Sintassi
DWORD WFDCloseSession(
[in] HANDLE hSessionHandle
);
Parametri
[in] hSessionHandle
Handle di sessione a una sessione Wi-Fi Diretta. Si tratta di un handle di sessione restituito in precedenza dalla funzione WFDStartOpenSession .
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 |
|---|---|
|
Handle non valido.
Questo errore viene restituito se l'handle specificato nel parametro hSessionHandle non è stato trovato nella tabella handle. |
|
Parametro non corretto.
Questo errore viene restituito se il parametro hSessionHandle è NULL o non è valido. |
|
Il gruppo o la risorsa non è nello stato corretto per eseguire l'operazione richiesta.
Questo errore viene restituito se il servizio Wi-Fi Diretto è disabilitato da Criteri di gruppo in un dominio. |
|
Vari codici di errore. |
Commenti
La funzione WFDCloseSession fa parte di Wi-Fi Direct, una nuova funzionalità in Windows 8 e Windows Server 2012. Wi-Fi Direct si basa sullo sviluppo della specifica tecnica peer-to-peer Wi-Fi dalla Wi-Fi Alliance (vedere Specifiche pubblicate di Wi-Fi Alliance). L'obiettivo della specifica tecnica peer-to-peer Wi-Fi è fornire una soluzione per Wi-Fi connettività da dispositivo a dispositivo senza la necessità di un punto di accesso wireless (AP wireless) per configurare la connessione o l'uso del meccanismo ad hoc (IBSS) Wi-Fi esistente.
La funzione WFDCloseSession accoda un elemento di lavoro futuro per chiudere la sessione, quindi la disconnessione potrebbe non essere immediata.
La chiamata alla funzione WFDCloseSession mentre una chiamata WFDStartOpenSession è in sospeso non chiuderà la sessione.
È responsabilità del chiamante passare la funzione WFDCloseSession a un handle nel parametro hSessionHandle restituito da una chiamata asincrona riuscita alla funzione WFDStartOpenSession .
La chiamata alla funzione WFDCloseSession con un handle valido e non valida restituirà risultati non definiti.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | wlanapi.h |
| Libreria | Wlanapi.lib |
| DLL | Wlanapi.dll |