Função WSACloseEvent (winsock2.h)

Artigo
03/13/2024

A função WSACloseEvent fecha um identificador de objeto de evento aberto.

Sintaxe

BOOL WSAAPI WSACloseEvent(
  [in] WSAEVENT hEvent
);

Parâmetros

[in] hEvent

Identificador de objeto que identifica o evento aberto.

Retornar valor

Se a função for bem-sucedida, o valor retornado será TRUE.

Se a função falhar, o valor retornado será FALSE. Para obter informações de erro estendidas, chame WSAGetLastError.

Código do erro	Significado
WSANOTINITIALISED	Uma chamada WSAStartup bem-sucedida deve ocorrer antes de usar essa função.
WSAENETDOWN	O subsistema de rede falhou.
WSAEINPROGRESS	Uma chamada de bloqueio do Windows Sockets 1.1 está em andamento ou o provedor de serviços ainda está processando uma função de retorno de chamada.
WSA_INVALID_HANDLE	O hEvent não é um identificador de objeto de evento válido.

Comentários

A função WSACloseEvent fecha o identificador de um objeto de evento e libera recursos associados ao objeto de evento. Essa função é usada para fechar um identificador criado pela função WSACreateEvent . Depois que o identificador do objeto de evento for fechado, outras referências a esse identificador falharão com o erro WSA_INVALID_HANDLE.

Windows Phone 8: essa função tem suporte para aplicativos da Windows Phone Store no Windows Phone 8 e posterior.

Windows 8.1 e Windows Server 2012 R2: essa função tem suporte para aplicativos da Windows Store em Windows 8.1, Windows Server 2012 R2 e posteriores.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8.1, Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	winsock2.h
Biblioteca	Ws2_32.lib
DLL	Ws2_32.dll