Función WFDCloseHandle (wlanapi.h)

Artículo
08/28/2023

La función WFDCloseHandle cierra un identificador para el servicio directo de Wi-Fi.

Sintaxis

DWORD WFDCloseHandle(
  [in] HANDLE hClientHandle
);

Parámetros

[in] hClientHandle

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

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 handle.
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.
RPC_STATUS	Varios códigos de error.

Comentarios

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

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


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