Fungsi ZwSetEvent (ntifs.h)

Artikel
02/26/2024

Rutinitas ZwSetEvent menetapkan objek peristiwa ke status Sinyal dan mencoba untuk memenuhi sebanyak mungkin menunggu.

Sintaks

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

Parameter

[in] EventHandle

Handel ke objek peristiwa.

[out, optional] PreviousState

Penunjuk opsional ke variabel tempat status objek peristiwa sebelumnya disimpan pada output.

Nilai kembali

ZwSetEvent mengembalikan STATUS_SUCCESS atau status kesalahan yang sesuai. Kemungkinan kode status kesalahan meliputi yang berikut ini:

Menampilkan kode	Deskripsi
STATUS_ACCESS_DENIED	Pemanggil tidak memiliki hak istimewa yang diperlukan untuk mengubah peristiwa yang ditentukan oleh parameter EventHandle .
STATUS_INSUFFICIENT_RESOURCES	Sumber daya yang diperlukan oleh fungsi ini tidak dapat dialokasikan.
STATUS_INVALID_HANDLE	Parameter EventHandle yang disediakan tidak valid.

Keterangan

ZwSetEvent mengatur objek peristiwa ke status Sinyal dan mencoba memenuhi sebanyak mungkin waktu tunggu.

Catatan Jika panggilan ke fungsi ZwSetEvent terjadi dalam mode pengguna, Anda harus menggunakan nama "NtSetEvent" alih-alih "ZwSetEvent".

Untuk panggilan dari driver mode kernel, versi NtXxx dan ZwXxx dari rutinItas Windows Native System Services dapat berperilaku berbeda dalam cara mereka menangani dan menginterpretasikan parameter input. Untuk informasi selengkapnya tentang hubungan antara versi NtXxx dan ZwXxx dari rutinitas, lihat Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP
Target Platform	Universal
Header	ntifs.h (termasuk Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL