Compartir a través de


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