Fungsi SetEvent (synchapi.h)

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

Lihat juga

CreateEvent

Objek Peristiwa

OpenEvent

PulseEvent

ResetEvent

Fungsi Sinkronisasi