WFD_OPEN_SESSION_COMPLETE_CALLBACK función de devolución de llamada (wlanapi.h)

Artículo
08/28/2023

La función WFD_OPEN_SESSION_COMPLETE_CALLBACK define la función de devolución de llamada a la que llama la función WFDStartOpenSession cuando se completa la operación WFDStartOpenSession .

Sintaxis

WFD_OPEN_SESSION_COMPLETE_CALLBACK WfdOpenSessionCompleteCallback;

void WfdOpenSessionCompleteCallback(
  [in] HANDLE hSessionHandle,
  [in] PVOID pvContext,
  [in] GUID guidSessionInterface,
  [in] DWORD dwError,
  [in] DWORD dwReasonCode
)
{...}

Parámetros

[in] hSessionHandle

Identificador de sesión de una sesión Wi-Fi sesión directa. Se trata de un identificador de sesión devuelto anteriormente por la función WFDStartOpenSession .

[in] pvContext

Puntero de contexto pasado a la función de devolución de llamada desde la función WFDStartOpenSession .

[in] guidSessionInterface

Guid de interfaz de la interfaz de red local en la que este dispositivo Wi-Fi Direct tiene una sesión abierta. Este parámetro es útil si los protocolos de capa superior necesitan determinar a qué interfaz de red está enlazada una sesión de Wi-Fi Direct. Este valor solo se devuelve si el parámetro dwError está ERROR_SUCCESS.

[in] dwError

Valor que especifica si se encontró un error durante la llamada a la función WFDStartOpenSession . Si este valor es ERROR_SUCCESS, no se produjo ningún error y la operación para abrir la sesión se completó correctamente.

Los siguientes valores son posibles:

Valor	Significado
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.
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 rpc y otros códigos de error. Use FormatMessage para obtener la cadena de mensaje para el error devuelto.

[in] dwReasonCode

Valor que especifica más detalles si se produjo un error durante WFDStartOpenSession.

Valor devuelto

None

Observaciones

La función WFD_OPEN_SESSION_COMPLETE_CALLBACK 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 del Wi-Fi especificación técnica punto a punto 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 adhoc (IBSS) existente.

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 de destino Wi-Fi debe haberse emparejado previamente a través de la experiencia de emparejamiento de Windows. Cuando se completa la operación asincrónica para realizar la conexión Wi-FI Direct, se llama a la función de devolución de llamada especificada en el parámetro pfnCallback .

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