Funzione WFDOpenLegacySession (wlanapi.h)

Articolo
03/13/2024

La funzione WFDOpenLegacySession recupera e applica un profilo archiviato per un dispositivo legacy Wi-Fi Direct.

Sintassi

DWORD WFDOpenLegacySession(
  HANDLE             hClientHandle,
  PDOT11_MAC_ADDRESS pLegacyMacAddress,
  HANDLE             *phSessionHandle,
  GUID               *pGuidSessionInterface
);

Parametri

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.

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_PARAMETER	Parametro non corretto. Questo errore viene restituito se il parametro phClientHandle o pLegacyMacAddress è NULL.
ERROR_NOT_ENOUGH_MEMORY	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.
RPC_STATUS	Vari codici di errore.

Commenti

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.

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