Função SetEvent (synchapi.h)

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

Confira também

CreateEvent

Objetos event

Openevent

Pulseevent

Resetevent

Funções de sincronização