Función WlanCloseHandle (wlanapi.h)

La función WlanCloseHandle cierra una conexión con el servidor.

Sintaxis

DWORD WlanCloseHandle(
  [in] HANDLE hClientHandle,
       PVOID  pReserved
);

Parámetros

[in] hClientHandle

Identificador de sesión del cliente, que identifica la conexión que se va a cerrar. Este identificador se obtuvo mediante una llamada anterior a la función WlanOpenHandle .

pReserved

Reservado para uso futuro. Establezca este parámetro en NULL.

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	hClientHandle es NULL o no es válido, o pReserved no es NULL.
ERROR_INVALID_HANDLE	No se encontró el identificador hClientHandle en la tabla handle.
RPC_STATUS	Varios códigos de error.

Observaciones

Una vez cerrada una conexión, cualquier uso intentado del identificador cerrado puede provocar errores inesperados. Al cerrar, se descartan todas las notificaciones pendientes.

No llame a WlanCloseHandle desde una función de devolución de llamada. Si el cliente está en medio de una devolución de llamada de notificación cuando se llama a WlanCloseHandle , la función espera a que finalice la devolución de llamada antes de devolver un valor. Llamar a esta función dentro de una función de devolución de llamada dará como resultado que la llamada nunca se complete. Si tanto la función de devolución de llamada como el subproceso que cierra el identificador intentan adquirir el mismo bloqueo, puede producirse un interbloqueo. Además, no llame a WlanCloseHandle desde la función DllMain en un archivo DLL de aplicación. Esto también podría provocar un interbloqueo.

Requisitos

Cliente mínimo compatible	Windows Vista, Windows XP con SP3 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wlanapi.h (incluya Wlanapi.h)
Library	Wlanapi.lib
Archivo DLL	Wlanapi.dll
Redistribuible	API de LAN inalámbrica para Windows XP con SP2

Consulte también

WlanOpenHandle