Função ResetEvent (synchapi.h)
Define o objeto de evento especificado como o estado não atribuído.
Sintaxe
BOOL ResetEvent(
[in] HANDLE hEvent
);
Parâmetros
[in] hEvent
Um identificador para o objeto de evento. A função CreateEvent ou OpenEvent retorna esse identificador.
O identificador deve ter o acesso de EVENT_MODIFY_STATE correto. Para obter mais informações, consulte Segurança do objeto de sincronização e direitos de acesso.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
O estado de um objeto de evento permanece não atribuído até que seja explicitamente definido como sinalizado pela função SetEvent ou PulseEvent . Esse estado não atribuído bloqueia a execução de todos os threads que especificaram o objeto de evento em uma chamada para uma das funções de espera.
A função ResetEvent é usada principalmente para objetos de evento de redefinição manual, que devem ser definidos explicitamente para o estado não atribuído. Os objetos de evento de redefinição automática são alterados automaticamente de sinalizados para não atribuídos depois que um único thread de espera é liberado.
Redefinir um evento que já está redefinido não tem efeito.
Requisitos
| Cliente mínimo com suporte | Windows XP [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 | synchapi.h (inclua Windows.h no Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |