Funzione WFDStartOpenSession (wlanapi.h)
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 |
|---|---|
|
Handle non valido.
Questo errore viene restituito se l'handle specificato nel parametro hClientHandle non è stato trovato nella tabella handle. |
|
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. |
|
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. |
|
Il servizio non è stato avviato.
Questo errore viene restituito se il servizio AutoConfig WLAN non è in esecuzione. |
|
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 |