Función WFDOpenHandle (wlanapi.h)

Artículo
03/13/2024

La función WFDOpenHandle abre un identificador para el servicio Wi-Fi Direct y negocia una versión de la API de Wi-FI Direct que se va a usar.

Sintaxis

DWORD WFDOpenHandle(
  [in]  DWORD   dwClientVersion,
  [out] PDWORD  pdwNegotiatedVersion,
  [out] PHANDLE phClientHandle
);

Parámetros

[in] dwClientVersion

La versión más alta de Wi-Fi Direct API que admite el cliente.

Para Windows 8 y Windows Server 2012, este parámetro debe establecerse en WFD_API_VERSION, constante definida en el archivo de encabezado Wlanapi.h.

[out] pdwNegotiatedVersion

Puntero a un DWORD para recibir la versión negociada.

Si la función WFDOpenHandle es correcta, se devuelve la versión negociada con el servicio directo Wi-Fi que usará esta sesión. Este valor suele ser la versión más alta compatible con el cliente y Wi-Fi servicio directo.

[out] phClientHandle

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

Si la función WFDOpenHandle se realiza correctamente, se devuelve un identificador para el servicio directo de Wi-Fi que se va a usar en esta sesión.

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 pdwNegotiatedVersion es NULL o el parámetro phClientHandle es NULL. Este valor también se devuelve si el parámetro dwClientVersion no es igual a WFD_API_VERSION.
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.
ERROR_REMOTE_SESSION_LIMIT_EXCEEDED	Se ha intentado establecer una sesión en un servidor de red, pero ya hay demasiadas sesiones establecidas en ese servidor. Este error se devuelve si el servicio Wi-Fi Direct ha emitido demasiados identificadores.
RPC_STATUS	Varios códigos de error.

Comentarios

La función WFDOpenHandle forma parte de Wi-Fi Direct, una nueva característica de 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.

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 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. Una vez que una aplicación haya terminado con el servicio Wi-Fi Direct, la aplicación debe 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