Funzione WFDStartOpenSession (wlanapi.h)

Articolo
03/13/2024

La funzione WFDStartOpenSession avvia una connessione su richiesta a un dispositivo specifico Wi-Fi Direct, che in precedenza è stato associato tramite l'esperienza di associazione di Windows.

Sintassi

DWORD WFDStartOpenSession(
  [in]           HANDLE                             hClientHandle,
  [in]           PDOT11_MAC_ADDRESS                 pDeviceAddress,
  [in, optional] PVOID                              pvContext,
  [in]           WFD_OPEN_SESSION_COMPLETE_CALLBACK pfnCallback,
  [out]          PHANDLE                            phSessionHandle
);

Parametri

[in] hClientHandle

Handle client al servizio Wi-Fi Direct. Questo handle è stato ottenuto da una chiamata precedente alla funzione WFDOpenHandle .

[in] pDeviceAddress

Puntatore all'indirizzo Wi-Fi dispositivo diretto del dispositivo di destinazione. Si tratta dell'indirizzo MAC del dispositivo di destinazione Wi-Fi.

[in, optional] pvContext

Puntatore di contesto facoltativo passato alla funzione di callback specificata nel parametro pfnCallback .

[in] pfnCallback

Puntatore alla funzione di callback da chiamare una volta completata la richiesta WFDStartOpenSession .

[out] phSessionHandle

Handle per questa sessione specifica Wi-Fi Direct.

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 hClientHandle non è stato trovato nella tabella handle.
ERROR_INVALID_PARAMETER	Parametro non corretto. Questo errore viene restituito se il parametro hClientHandle è NULL o non valido. Questo errore viene restituito anche se il parametro pDeviceAddress è NULL, il parametro pfnCallback è NULL o il parametro phSessionHandle è NULL. Questo valore viene restituito anche se il parametro dwClientVersion non è uguale a WFD_API_VERSION.
ERROR_INVALID_STATE	Il gruppo o la risorsa non è nello stato corretto per eseguire l'operazione richiesta. Questo errore viene restituito se il servizio diretto Wi-Fi è disabilitato dai criteri di gruppo in un dominio.
ERROR_SERVICE_NOT_ACTIVE	Il servizio non è stato avviato. Questo errore viene restituito se il servizio AutoConfig WLAN non è in esecuzione.
RPC_STATUS	Vari codici di errore.

Commenti

La funzione WFDStartOpenSession 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.

La funzione WFDStartOpenSession avvia un'operazione asincrona per avviare una connessione su richiesta a un dispositivo diretto Wi-Fi specifico. Il dispositivo di destinazione Wi-Fi deve essere stato associato in precedenza tramite l'esperienza di associazione di Windows. Al termine dell'operazione asincrona, viene chiamata la funzione di callback specificata nel parametro pfnCallback .

Se l'applicazione tenta di chiudere l'handle al Wi-Fi servizio diretto chiamando la funzione WFDCloseHandle prima che la funzione WFDStartOpenSession venga completata in modo asincrono, la funzione WFDCloseHandle attenderà fino al completamento della chiamata 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