Funzione WFDOpenHandle (wlanapi.h)
La funzione WFDOpenHandle apre un handle al Wi-Fi Servizio diretto e negozia una versione dell'API Wi-FI Direct da usare.
Sintassi
DWORD WFDOpenHandle(
[in] DWORD dwClientVersion,
[out] PDWORD pdwNegotiatedVersion,
[out] PHANDLE phClientHandle
);
Parametri
[in] dwClientVersion
La versione più alta dell'API diretta Wi-Fi supportata dal client.
Per Windows 8 e Windows Server 2012, questo parametro deve essere impostato su WFD_API_VERSION, costante definita nel file di intestazione Wlanapi.h.
[out] pdwNegotiatedVersion
Puntatore a una DWORD per ricevere la versione negoziata.
Se la funzione WFDOpenHandle ha esito positivo, viene restituita la versione negoziata con il Wi-Fi Servizio diretto da utilizzare da questa sessione. Questo valore è in genere la versione più alta supportata sia dal client che dal Wi-Fi servizio diretto.
[out] phClientHandle
Puntatore a un handle per ricevere l'handle nel servizio diretto Wi-Fi per questa sessione.
Se la funzione WFDOpenHandle ha esito positivo, viene restituito un handle al servizio Wi-Fi Direct da usare in questa sessione.
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 |
|---|---|
|
Parametro non corretto.
Questo errore viene restituito se il parametro pdwNegotiatedVersion è NULL o il parametro phClientHandle è NULL. Questo valore viene restituito anche se il parametro dwClientVersion non è uguale a WFD_API_VERSION. |
|
L'archiviazione non è sufficiente per elaborare questo comando.
Questo errore viene restituito se il sistema non è riuscito a allocare memoria per creare il contesto client. |
|
È stato effettuato un tentativo di stabilire una sessione a un server di rete, ma sono già state stabilite troppe sessioni a tale server.
Questo errore viene restituito se sono stati rilasciati troppi handle dal servizio diretto Wi-Fi. |
|
Vari codici di errore. |
Commenti
La funzione WFDOpenHandle 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.
Per usare Wi-Fi Direct, un'applicazione deve prima ottenere un handle per il servizio Wi-Fi Direct chiamando la funzione WFDOpenHandle . L'handle Wi-Fi Direct (WFD) restituito dalla funzione WFDOpenHandle viene usato per le chiamate successive effettuate al servizio Wi-Fi Direct. Una volta eseguita l'uso di un'applicazione tramite il servizio diretto Wi-Fi, l'applicazione deve chiamare la funzione WFDCloseHandle per segnalare al servizio Wi-Fi Direct che l'applicazione viene eseguita usando il servizio. Ciò consente al servizio Wi-Fi Direct di rilasciare le risorse usate dall'applicazione.
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 |