Fungsi SetThreadpoolWait (threadpoolapiset.h)

Artikel
03/08/2023

Mengatur objek tunggu, mengganti objek tunggu sebelumnya, jika ada. Utas pekerja memanggil fungsi panggilan balik objek tunggu setelah handel diberi sinyal atau setelah batas waktu yang ditentukan kedaluwarsa.

Sintaks

void SetThreadpoolWait(
  [in, out]      PTP_WAIT  pwa,
  [in, optional] HANDLE    h,
  [in, optional] PFILETIME pftTimeout
);

Parameter

[in, out] pwa

Penunjuk ke struktur TP_WAIT yang menentukan objek tunggu. Fungsi CreateThreadpoolWait mengembalikan penunjuk ini.

[in, optional] h

Pegangan.

Jika parameter ini NULL, objek tunggu akan berhenti mengantre panggilan balik baru (tetapi panggilan balik yang sudah diantrekan masih akan terjadi).

Jika parameter ini bukan NULL, parameter harus merujuk ke objek yang dapat ditunda yang valid.

Jika handel ini ditutup saat penantian masih tertunda, perilaku fungsi tidak terdefinis. Jika penantian masih tertunda dan handel harus ditutup, gunakan CloseThreadpoolWait untuk membatalkan tunggu lalu tutup handel.

Penantian dianggap diatur jika parameter ini bukan NULL.

[in, optional] pftTimeout

Penunjuk ke struktur FILETIME yang menentukan waktu absolut atau relatif di mana operasi tunggu harus kehabisan waktu. Jika parameter ini menunjuk ke nilai positif, parameter menunjukkan waktu absolut sejak 1 Januari 1601 (UTC), dalam interval 100 nanodetik. Jika parameter ini menunjuk ke nilai negatif, parameter menunjukkan jumlah waktu untuk menunggu relatif terhadap waktu saat ini. Untuk informasi selengkapnya tentang nilai waktu, lihat Waktu File.

Jika parameter ini menunjuk ke 0, waktu tunggu segera habis. Jika parameter ini NULL, waktu tunggu tidak akan habis.

Mengembalikan nilai

Tidak ada

Keterangan

Objek tunggu hanya dapat menunggu satu handel. Mengatur handel untuk objek tunggu menggantikan handel sebelumnya, jika ada.

Anda harus mendaftarkan ulang peristiwa dengan objek tunggu sebelum memberi sinyal setiap kali untuk memicu panggilan balik tunggu.

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0600 atau lebih tinggi.

Contoh

Misalnya, lihat Menggunakan Fungsi Kumpulan Utas.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	threadpoolapiset.h (termasuk Windows.h pada Windows 7, Windows Server 2008 Windows Server 2008 R2)
Pustaka	Kernel32.lib
DLL	Kernel32.dll