Função ResetEvent (synchapi.h)

Artigo
08/26/2023

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