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 |
|---|---|
| Uma chamada WSAStartup bem-sucedida deve ocorrer antes de usar essa função. | |
| O subsistema de rede falhou. | |
| 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. | |
| 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 |