Compartilhar via


Função WSAResetEvent (winsock2.h)

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

Confira também

WSACloseEvent

Wsacreateevent

WSAEnumNetworkEvents

Wsaeventselect

WSASetEvent

Funções Winsock

Referência de Winsock