Funzione WFDCloseSession (wlanapi.h)

Articolo
03/04/2024

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
ERROR_INVALID_HANDLE	Handle non valido. Questo errore viene restituito se l'handle specificato nel parametro hSessionHandle non è stato trovato nella tabella handle.
ERROR_INVALID_PARAMETER	Parametro non corretto. Questo errore viene restituito se il parametro hSessionHandle è NULL o non è valido.
ERROR_INVALID_STATE	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.
RPC_STATUS	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