Fungsi ResetEvent (synchapi.h)

Artikel
03/08/2023

Mengatur objek peristiwa yang ditentukan ke status tidak ditandatangani.

Sintaks

BOOL ResetEvent(
  [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.

Menampilkan nilai

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 tetap tidak ditandatangani sampai secara eksplisit diatur ke sinyal oleh fungsi SetEvent atau PulseEvent . Status yang tidak ditandatangani ini memblokir eksekusi utas apa pun yang telah menentukan objek peristiwa dalam panggilan ke salah satu fungsi tunggu.

Fungsi ResetEvent digunakan terutama untuk objek peristiwa reset manual, yang harus diatur secara eksplisit ke status tidak ditandatangani. Objek peristiwa reset otomatis secara otomatis berubah dari disinyalkan menjadi tidak ditandatangani setelah satu utas tunggu dirilis.

Mereset peristiwa yang sudah direset tidak berpengaruh.

Persyaratan


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