Funzione WFDOpenLegacySession (wlanapi.h)
La funzione WFDOpenLegacySession recupera e applica un profilo archiviato per un dispositivo legacy Wi-Fi Direct.
DWORD WFDOpenLegacySession(
HANDLE hClientHandle,
PDOT11_MAC_ADDRESS pLegacyMacAddress,
HANDLE *phSessionHandle,
GUID *pGuidSessionInterface
);
hClientHandle
Handle al Wi-Fi servizio diretto per questa sessione. Questo parametro viene recuperato usando la funzione WFDOpenHandle .
pLegacyMacAddress
Puntatore a Wi-Fi indirizzo del dispositivo client diretto del dispositivo client legacy.
phSessionHandle
Puntatore a un handle per ricevere l'handle nel servizio diretto Wi-Fi per questa sessione.
Se la funzione WFDOpenLegacySession ha esito positivo, viene restituito un handle al servizio Wi-Fi Direct da usare in questa sessione.
pGuidSessionInterface
Puntatore al GUID dell'interfaccia di rete per questa sessione.
Se la funzione WFDOpenLegacySession ha esito positivo, viene restituito un GUID dell'interfaccia di rete in cui viene restituita Wi-Fi sessione diretta.
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 phClientHandle o pLegacyMacAddress è NULL. |
|
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. |
|
Vari codici di errore. |
La funzione WFDOpenLegacySession 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 WFDOpenLegacySession o WFDOpenHandle . L'handle Wi-Fi Direct (WFD) restituito dalla funzione WFDOpenHandle viene usato per le chiamate successive effettuate al servizio Wi-Fi Direct. La funzione WFDOpenLegacySession viene usata per recuperare e applicare un profilo archiviato per un dispositivo legacy Wi-Fi Direct.
La funzione WFDOpenLegacySession recupera il profilo legacy archiviato per il dispositivo dall'archivio profili per l'indirizzo del dispositivo legacy specificato. Questo indirizzo del dispositivo deve essere ottenuto da un nodo dispositivo creato come risultato dell'esperienza di associazione posta in arrivo (Associazione WPS legacy).
Dopo che un'applicazione viene eseguita usando il servizio Wi-Fi Direct, l'applicazione deve chiamare la funzione WFDCloseSession per chiudere la sessione e 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.
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 |