Função SetEvent (synchapi.h)

Artigo
03/02/2024

Define o objeto de evento especificado como o estado sinalizado.

Sintaxe

BOOL SetEvent(
  [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 direito de acesso EVENT_MODIFY_STATE. 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 de redefinição manual permanece sinalizado até que seja definido explicitamente para o estado não atribuído pela função ResetEvent . Qualquer número de threads em espera ou threads que, posteriormente, iniciam operações de espera para o objeto de evento especificado chamando uma das funções de espera, pode ser liberado enquanto o estado do objeto é sinalizado.

Por outro lado, o estado de um objeto de evento de redefinição automática permanece sinalizado até que um único thread de espera seja liberado, momento em que o sistema define automaticamente o estado como não atribuído. Se nenhum thread estiver aguardando, o estado do objeto de evento permanecerá sinalizado.

Definir um evento que já está definido não tem efeito.

Os aplicativos da Windows Store podem responder a eventos nomeados e semáforos, conforme descrito em Como responder a eventos nomeados e semáforos.

Exemplos

Para obter um exemplo que usa SetEvent, consulte Usando objetos de evento.

Requisitos

Requisito	Valor
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