Fungsi OpenWaitableTimerW (synchapi.h)

Membuka objek timer yang dapat diantisipasi bernama yang sudah ada.

Sintaks

HANDLE OpenWaitableTimerW(
  [in] DWORD   dwDesiredAccess,
  [in] BOOL    bInheritHandle,
  [in] LPCWSTR lpTimerName
);

Parameter

[in] dwDesiredAccess

Akses ke objek timer. Fungsi gagal jika pendeskripsi keamanan objek yang ditentukan tidak mengizinkan akses yang diminta untuk proses panggilan. Untuk daftar hak akses, lihat Sinkronisasi Keamanan Objek dan Hak Akses.

[in] bInheritHandle

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

[in] lpTimerName

Nama objek timer. Nama terbatas pada karakter MAX_PATH . Perbandingan nama peka huruf besar/kecil.

Fungsi ini dapat membuka objek di namespace privat. Untuk informasi selengkapnya, lihat Namespace Objek.

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.

Catatan Pengalihan 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 pedoman yang diuraikan untuk Layanan Terminal sehingga aplikasi dapat mendukung beberapa pengguna.

Nilai kembali

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

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

Keterangan

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

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

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0400 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

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 (sertakan Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

CancelWaitableTimer

CloseHandle

CreateProcess

CreateWaitableTimer

DuplikatHandle

Nama Objek

SetWaitableTimer

Fungsi Sinkronisasi

Objek Timer yang Dapat Ditunda