Fungsi NtWaitForSingleObject (winternl.h)

Artikel
03/13/2024

Dihentikan. Menunggu hingga objek yang ditentukan mencapai status signaled. NtWaitForSingleObject digantikan oleh WaitForSingleObject.

Sintaks

NTSTATUS NtWaitForSingleObject(
  [in] HANDLE         Handle,
  [in] BOOLEAN        Alertable,
  [in] PLARGE_INTEGER Timeout
);

Parameter

[in] Handle

Handel ke objek tunggu.

[in] Alertable

Menentukan apakah pemberitahuan dapat dikirimkan saat objek sedang menunggu.

TRUE

Pemberitahuan dapat dikirimkan.

FALSE

Pemberitahuan tidak dapat dikirimkan.

[in] Timeout

Penunjuk ke waktu absolut atau relatif di mana penantian akan terjadi. Bisa null. Jika batas waktu ditentukan, dan objek belum mencapai status signaled kapan batas waktu habis berakhir, maka penantian akan terpenuhi secara otomatis. Jika nilai batas waktu eksplisit nol ditentukan, maka tidak ada penantian yang terjadi jika penantian tidak dapat segera dipenuhi.

Menampilkan nilai

Status penyelesaian tunggu. Berbagai nilai NTSTATUS didefinisikan dalam NTSTATUS. H, yang didistribusikan dengan Windows DDK.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Objek yang ditentukan memenuhi waktu tunggu.
STATUS_TIMEOUT	Waktu habis terjadi.
STATUS_ALERTED	Penantian dibatalkan untuk mengirimkan pemberitahuan ke utas saat ini.
STATUS_USER_APC	Penantian dibatalkan untuk mengirimkan Panggilan Prosedur Asinkron (APC) pengguna ke utas saat ini.

Keterangan

Karena tidak ada pustaka impor untuk fungsi ini, Anda harus menggunakan GetProcAddress.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winternl.h
Pustaka	ntdll.lib
DLL	ntdll.dll

Bagikan melalui