Fungsi SetEvent (synchapi.h)

Artikel
03/04/2024

Mengatur objek peristiwa yang ditentukan ke status yang disinyalir.

Sintaks

BOOL SetEvent(
  [in] HANDLE hEvent
);

Parameter

[in] hEvent

Handel ke objek peristiwa. Fungsi CreateEvent atau OpenEvent mengembalikan handel ini.

Handel harus memiliki hak akses EVENT_MODIFY_STATE. Untuk informasi selengkapnya, lihat Keamanan Objek Sinkronisasi dan Hak Akses.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Status objek peristiwa reset manual tetap diberi sinyal sampai diatur secara eksplisit ke status nonsignaled oleh fungsi ResetEvent . Sejumlah utas tunggu, atau utas yang kemudian memulai operasi tunggu untuk objek peristiwa yang ditentukan dengan memanggil salah satu fungsi tunggu, dapat dilepaskan saat status objek diberi sinyal.

Sebaliknya, status objek peristiwa reset otomatis tetap diberi sinyal sampai satu utas tunggu dirilis, pada saat itu sistem secara otomatis mengatur status ke nonsignaled. Jika tidak ada utas yang menunggu, status objek peristiwa tetap diberi sinyal.

Mengatur peristiwa yang sudah diatur tidak berpengaruh.

Aplikasi Windows Store dapat merespons peristiwa bernama dan semaphores seperti yang dijelaskan dalam Cara merespons peristiwa bernama dan semaphores.

Contoh

Untuk contoh yang menggunakan SetEvent, lihat Menggunakan Objek Peristiwa.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	synchapi.h (termasuk Windows.h pada Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Pustaka	Kernel32.lib
DLL	Kernel32.dll