Compartilhar via


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

Confira também

CreateEvent

Objetos de evento

Openevent

Pulseevent

SetEvent

Funções de sincronização