Função WSAResetEvent (winsock2.h)

Artigo
08/27/2023

A função WSAResetEvent redefine o estado do objeto de evento especificado como não atribuído.

Sintaxe

BOOL WSAAPI WSAResetEvent(
  [in] WSAEVENT hEvent
);

Parâmetros

[in] hEvent

Um identificador que identifica um identificador de objeto de evento aberto.

Valor retornado

Se a função WSAResetEvent 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 parâmetro hEvent não é um identificador de objeto de evento válido.

Comentários

A função WSAResetEvent é usada para definir o estado do objeto de evento como não atribuído.

A maneira adequada de redefinir o estado de um objeto de evento usado com a função WSAEventSelect é passar o identificador do objeto de evento para a função WSAEnumNetworkEvents no parâmetro hEventObject . Isso redefinirá o objeto de evento e ajustará o status de eventos FD ativos no soquete de maneira atômica.

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 posterior.

Requisitos


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