Función WFDStartOpenSession (wlanapi.h)

Artículo
03/13/2024

La función WFDStartOpenSession inicia una conexión a petición a un dispositivo específico Wi-Fi Direct, que se ha emparejado previamente a través de la experiencia de emparejamiento de Windows.

Sintaxis

DWORD WFDStartOpenSession(
  [in]           HANDLE                             hClientHandle,
  [in]           PDOT11_MAC_ADDRESS                 pDeviceAddress,
  [in, optional] PVOID                              pvContext,
  [in]           WFD_OPEN_SESSION_COMPLETE_CALLBACK pfnCallback,
  [out]          PHANDLE                            phSessionHandle
);

Parámetros

[in] hClientHandle

Un identificador de cliente para el servicio Wi-Fi Direct. Este identificador se obtuvo mediante una llamada anterior a la función WFDOpenHandle .

[in] pDeviceAddress

Puntero a la dirección del dispositivo de destino Wi-Fi direct. Esta es la dirección MAC del dispositivo Wi-Fi de destino.

[in, optional] pvContext

Puntero de contexto opcional que se pasa a la función de devolución de llamada especificada en el parámetro pfnCallback .

[in] pfnCallback

Puntero a la función de devolución de llamada a la que se llamará una vez completada la solicitud WFDStartOpenSession .

[out] phSessionHandle

Identificador de esta sesión específica de Wi-Fi Direct.

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_HANDLE	El identificador no es válido. Este error se devuelve si no se encontró el identificador especificado en el parámetro hClientHandle en la tabla de identificadores.
ERROR_INVALID_PARAMETER	El parámetro no es correcto. Este error se devuelve si el parámetro hClientHandle es NULL o no es válido. Este error también se devuelve si el parámetro pDeviceAddress es NULL, el parámetro pfnCallback es NULL o el parámetro phSessionHandle es NULL. Este valor también se devuelve si el parámetro dwClientVersion no es igual a WFD_API_VERSION.
ERROR_INVALID_STATE	El grupo o recurso no está en el estado correcto para realizar la operación solicitada. Este error se devuelve si la directiva de grupo de Wi-Fi servicio directo está deshabilitada por directiva de grupo en un dominio.
ERROR_SERVICE_NOT_ACTIVE	El servicio no se ha iniciado. Este error se devuelve si el servicio WLAN AutoConfig no se está ejecutando.
RPC_STATUS	Varios códigos de error.

Comentarios

La función WFDStartOpenSession 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).

La función WFDStartOpenSession inicia una operación asincrónica para iniciar una conexión a petición a un dispositivo específico Wi-Fi Direct. El dispositivo Wi-Fi de destino debe haberse emparejado previamente a través de la experiencia de emparejamiento de Windows. Cuando se completa la operación asincrónica, se llama a la función de devolución de llamada especificada en el parámetro pfnCallback .

Si la aplicación intenta cerrar el identificador del servicio Wi-Fi Direct mediante una llamada a la función WFDCloseHandle antes de que la función WFDStartOpenSession se complete de forma asincrónica, la función WFDCloseHandle esperará hasta que se complete la llamada a WFDStartOpenSession .

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