Función WFDOpenLegacySession (wlanapi.h)

Artículo
08/28/2023

La función WFDOpenLegacySession recupera y aplica un perfil almacenado para un dispositivo heredado de Wi-Fi Direct.

Sintaxis

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

Parámetros

hClientHandle

Identificador del servicio Wi-Fi Direct para esta sesión. Este parámetro se recupera mediante la función WFDOpenHandle .

pLegacyMacAddress

Puntero a Wi-Fi dirección de dispositivo directo del dispositivo cliente heredado.

phSessionHandle

Puntero a un identificador para recibir el identificador al servicio Wi-Fi Direct para esta sesión.

Si la función WFDOpenLegacySession se realiza correctamente, se devuelve un identificador del servicio directo de Wi-Fi que se usará en esta sesión.

pGuidSessionInterface

Puntero al GUID de la interfaz de red para esta sesión.

Si la función WFDOpenLegacySession es correcta, se devuelve un GUID de la interfaz de red en la que se devuelve Wi-Fi sesión directa.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de retorno.

Código devuelto	Descripción
ERROR_INVALID_PARAMETER	El parámetro no es correcto. Este error se devuelve si el parámetro phClientHandle o pLegacyMacAddress es NULL.
ERROR_NOT_ENOUGH_MEMORY	No hay suficiente almacenamiento disponible para procesar este comando. Este error se devuelve si el sistema no pudo asignar memoria para crear el contexto de cliente.
RPC_STATUS	Varios códigos de error.

Comentarios

La función WFDOpenLegacySession forma parte de Wi-Fi Direct, una nueva característica en Windows 8 y Windows Server 2012. Wi-Fi Direct se basa en el desarrollo de la especificación técnica punto a punto de Wi-Fi v1.1 de la Wi-Fi Alliance (consulte Especificaciones publicadas de Wi-Fi Alliance). El objetivo de la especificación técnica punto a punto de Wi-Fi es proporcionar una solución para Wi-Fi conectividad de dispositivo a dispositivo sin necesidad de un punto de acceso inalámbrico (AP inalámbrico) para configurar la conexión o el uso del mecanismo Wi-Fi existente adhoc (IBSS).

Para usar Wi-Fi Direct, una aplicación primero debe obtener un identificador para el servicio Wi-Fi Direct mediante una llamada a la función WFDOpenLegacySession o WFDOpenHandle . El identificador de Wi-Fi Direct (WFD) devuelto por la función WFDOpenHandle se usa para las llamadas posteriores realizadas al servicio Wi-Fi Direct. La función WFDOpenLegacySession se usa para recuperar y aplicar un perfil almacenado para un dispositivo heredado de Wi-Fi Direct.

La función WFDOpenLegacySession recupera el perfil heredado almacenado para el dispositivo del almacén de perfiles para la dirección de dispositivo heredada especificada. Esta dirección del dispositivo debe obtenerse de un nodo de dispositivo creado como resultado de la experiencia de emparejamiento de bandeja de entrada (emparejamiento de WPS heredado).

Una vez que una aplicación se realiza mediante el servicio Wi-Fi Direct, la aplicación debe llamar a la función WFDCloseSession para cerrar la sesión y llamar a la función WFDCloseHandle para indicar al servicio Wi-Fi Direct que la aplicación se realiza mediante el servicio. Esto permite que el servicio Wi-Fi Direct libere los recursos usados por la aplicación.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wlanapi.h
Library	Wlanapi.lib
Archivo DLL	Wlanapi.dll