Função ZwSetEvent (ntifs.h)

Artigo
03/01/2024

A rotina ZwSetEvent define um objeto de evento como um estado Sinalizado e tenta satisfazer o maior número possível de esperas.

Sintaxe

NTSYSAPI NTSTATUS ZwSetEvent(
  [in]            HANDLE EventHandle,
  [out, optional] PLONG  PreviousState
);

Parâmetros

[in] EventHandle

Um identificador para um objeto de evento.

[out, optional] PreviousState

Um ponteiro opcional para uma variável em que o estado anterior do objeto de evento é armazenado na saída.

Retornar valor

ZwSetEvent retorna STATUS_SUCCESS ou um erro apropriado status. Os possíveis códigos de status de erro incluem o seguinte:

Código de retorno	Descrição
STATUS_ACCESS_DENIED	O chamador não tinha os privilégios necessários para modificar o evento especificado pelo parâmetro EventHandle .
STATUS_INSUFFICIENT_RESOURCES	Não foi possível alocar recursos exigidos por essa função.
STATUS_INVALID_HANDLE	O parâmetro EventHandle fornecido era inválido.

Comentários

ZwSetEvent define um objeto de evento como um estado Sinalizado e tenta satisfazer o maior número possível de esperas.

Nota Se a chamada para a função ZwSetEvent ocorrer no modo de usuário, você deverá usar o nome "NtSetEvent" em vez de "ZwSetEvent".

Para chamadas de drivers no modo kernel, as versões NtXxx e ZwXxx de uma rotina dos Serviços do Sistema Nativo do Windows podem se comportar de forma diferente na maneira como lidam e interpretam parâmetros de entrada. Para obter mais informações sobre a relação entre as versões NtXxx e ZwXxx de uma rotina, consulte Usando versões Nt e Zw das rotinas dos Serviços de Sistema Nativo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (inclua Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL