Función WSACloseEvent (winsock2.h)

Artículo
08/27/2023

La función WSACloseEvent cierra un identificador de objeto de evento abierto.

Sintaxis

BOOL WSAAPI WSACloseEvent(
  [in] WSAEVENT hEvent
);

Parámetros

[in] hEvent

Identificador de objeto que identifica el evento open.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es TRUE.

Si se produce un error en la función, el valor devuelto es FALSE. Para obtener información de error extendida, llame a WSAGetLastError.

Código de error	Significado
WSANOTINITIALISED	Debe producirse una llamada WSAStartup correcta antes de usar esta función.
WSAENETDOWN	Error en el subsistema de red.
WSAEINPROGRESS	Una llamada de Bloqueo de Windows Sockets 1.1 está en curso o el proveedor de servicios sigue procesando una función de devolución de llamada.
WSA_INVALID_HANDLE	HEvent no es un identificador de objeto de evento válido.

Comentarios

La función WSACloseEvent cierra el identificador de un objeto de evento y libera los recursos asociados al objeto de evento. Esta función se usa para cerrar un identificador creado por la función WSACreateEvent . Una vez cerrado el identificador del objeto de evento, se producirá un error en las referencias adicionales a este identificador con el error WSA_INVALID_HANDLE.

Windows Phone 8: esta función es compatible con las aplicaciones de Windows Phone Store en Windows Phone 8 y versiones posteriores.

Windows 8.1 y Windows Server 2012 R2: esta función es compatible con las aplicaciones de la Tienda Windows en Windows 8.1, Windows Server 2012 R2 y versiones posteriores.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8.1, Windows Vista [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	winsock2.h
Library	Ws2_32.lib
Archivo DLL	Ws2_32.dll