Funzione WFDCancelOpenSession (wlanapi.h)

Articolo
03/13/2024

La funzione WFDCancelOpenSession indica che l'applicazione vuole annullare una funzione WFDStartOpenSession in sospeso non completata.

Sintassi

DWORD WFDCancelOpenSession(
  [in] HANDLE hSessionHandle
);

Parametri

[in] hSessionHandle

Handle di sessione in una sessione Wi-Fi Diretta da annullare. Questo è un handle di sessione restituito in precedenza dalla funzione WFDStartOpenSession .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è 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.
RPC_STATUS	Vari codici di errore.

Commenti

La funzione WFDCancelOpenSession 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 di Wi-Fi è fornire una soluzione per Wi-Fi connettività da dispositivo a dispositivo senza la necessità di un punto di accesso wireless (API wireless) per configurare la connessione o l'uso del meccanismo adhoc (IBSS) Wi-Fi esistente.

Una chiamata alla funzione WFDCancelOpenSession notifica al servizio diretto Wi-Fi che il client richiede un annullamento della sessione. La funzione WFDCancelOpenSession non modifica il comportamento previsto di WFDStartOpenSession . La funzione di callback specificata alla funzione WFDStartOpenSession verrà comunque chiamata e la funzione WFDStartOpenSession potrebbe non essere completata immediatamente.

È responsabilità del chiamante passare la funzione WFDCancelOpenSession a un handle nel parametro hSessionHandle restituito dalla chiamata alla funzione WFDStartOpenSession .

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