WFD_OPEN_SESSION_COMPLETE_CALLBACK funzione di callback (wlanapi.h)

Articolo
03/04/2024

La funzione WFD_OPEN_SESSION_COMPLETE_CALLBACK definisce la funzione di callback chiamata dalla funzione WFDStartOpenSession al termine dell'operazione WFDStartOpenSession .

Sintassi

WFD_OPEN_SESSION_COMPLETE_CALLBACK WfdOpenSessionCompleteCallback;

void WfdOpenSessionCompleteCallback(
  [in] HANDLE hSessionHandle,
  [in] PVOID pvContext,
  [in] GUID guidSessionInterface,
  [in] DWORD dwError,
  [in] DWORD dwReasonCode
)
{...}

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 .

[in] pvContext

Puntatore di contesto passato alla funzione di callback dalla funzione WFDStartOpenSession .

[in] guidSessionInterface

GUID dell'interfaccia dell'interfaccia di rete locale in cui questo dispositivo Wi-Fi diretto ha una sessione aperta. Questo parametro è utile se i protocolli di livello superiore devono determinare a quale interfaccia di rete è associata una sessione Wi-Fi diretta. Questo valore viene restituito solo se il parametro dwError è ERROR_SUCCESS.

[in] dwError

Valore che specifica se si è verificato un errore durante la chiamata alla funzione WFDStartOpenSession . Se questo valore è ERROR_SUCCESS, non si è verificato alcun errore e l'operazione per aprire la sessione è stata completata correttamente.

Sono possibili gli altri valori seguenti:

Valore	Significato
ERROR_INVALID_PARAMETER	Parametro non corretto. Questo errore viene restituito se il parametro hClientHandle è 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.
ERROR_SERVICE_NOT_ACTIVE	Il servizio non è stato avviato. Questo errore viene restituito se il servizio WLAN AutoConfig non è in esecuzione.
RPC_STATUS	Vari codici di errore RPC e altri. Usare FormatMessage per ottenere la stringa del messaggio per l'errore restituito.

[in] dwReasonCode

Valore che specifica il maggior dettaglio se si è verificato un errore durante WFDStartOpenSession.

Valore restituito

nessuno

Osservazioni

La funzione WFD_OPEN_SESSION_COMPLETE_CALLBACK 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 WFDStartOpenSession avvia un'operazione asincrona per avviare una connessione su richiesta a un dispositivo specifico Wi-Fi Direct. Il dispositivo di destinazione Wi-Fi deve essere stato associato in precedenza tramite l'esperienza di associazione di Windows. Quando l'operazione asincrona per eseguire la connessione wi-FI diretta viene completata, viene chiamata la funzione di callback specificata nel parametro pfnCallback .

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