Fungsi OpenEventA (synchapi.h)

Artikel
11/20/2024

Membuka objek peristiwa bernama yang sudah ada.

Sintaksis

HANDLE OpenEventA(
  [in] DWORD  dwDesiredAccess,
  [in] BOOL   bInheritHandle,
  [in] LPCSTR lpName
);

Parameter

[in] dwDesiredAccess

Akses ke objek peristiwa. Fungsi gagal jika pendeskripsi keamanan objek yang ditentukan tidak mengizinkan akses yang diminta untuk proses panggilan. Untuk daftar hak akses, lihat Synchronization Object Security and Access Rights.

[in] bInheritHandle

Jika nilai ini TRUE, proses yang dibuat oleh proses ini akan mewarisi handel. Jika tidak, proses tidak mewarisi handel ini.

[in] lpName

Nama peristiwa yang akan dibuka. Perbandingan nama peka huruf besar/kecil.

Fungsi ini dapat membuka objek di namespace privat. Untuk informasi selengkapnya, lihat Object Namespaces.

Layanan Terminal: Nama dapat memiliki awalan "Global" atau "Lokal" untuk secara eksplisit membuka objek di namespace layanan global atau sesi. Sisa nama dapat berisi karakter apa pun kecuali karakter garis miring terbelakang (\). Untuk informasi selengkapnya, lihat Namespace Objek Kernel.

Note Peralihan pengguna Cepat diimplementasikan menggunakan sesi Layanan Terminal. Pengguna pertama yang masuk menggunakan sesi 0, pengguna berikutnya untuk masuk menggunakan sesi 1, dan sebagainya. Nama objek kernel harus mengikuti panduan yang diuraikan untuk Layanan Terminal sehingga aplikasi dapat mendukung beberapa pengguna.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke objek peristiwa.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Fungsi OpenEvent memungkinkan beberapa proses untuk membuka handel objek peristiwa yang sama. Fungsi ini hanya berhasil jika beberapa proses telah membuat peristiwa dengan menggunakan fungsi CreateEvent. Proses panggilan dapat menggunakan handel yang dikembalikan dalam fungsi apa pun yang memerlukan handel ke objek peristiwa, tunduk pada batasan akses yang ditentukan dalam parameter dwDesiredAccess.

Handel dapat diduplikasi dengan menggunakan fungsi DuplicateHandle. Gunakan fungsi CloseHandle untuk menutup handel. Sistem menutup handel secara otomatis ketika proses berakhir. Objek peristiwa dihancurkan ketika handel terakhirnya telah ditutup.

Nota

Header synchapi.h mendefinisikan OpenEvent sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Platform Target	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

Lihat juga

closeHandle

CreateEvent

CreateProcess

DuplicateHandle

Objek Peristiwa

Nama Objek

PulseEvent

ResetEvent

SetEvent

Fungsi Sinkronisasi

Bagikan melalui