Fungsi CreateThreadpoolWait (threadpoolapiset.h)

Artikel
03/08/2023

Membuat objek tunggu baru.

Sintaks

PTP_WAIT CreateThreadpoolWait(
  [in]                PTP_WAIT_CALLBACK    pfnwa,
  [in, out, optional] PVOID                pv,
  [in, optional]      PTP_CALLBACK_ENVIRON pcbe
);

Parameter

[in] pfnwa

Fungsi panggilan balik untuk memanggil ketika waktu tunggu selesai atau waktu habis. Untuk detailnya, lihat WaitCallback.

[in, out, optional] pv

Data opsional yang ditentukan aplikasi untuk diteruskan ke fungsi panggilan balik.

[in, optional] pcbe

Struktur TP_CALLBACK_ENVIRON yang menentukan lingkungan untuk menjalankan panggilan balik. Fungsi InitializeThreadpoolEnvironment mengembalikan struktur ini.

Jika parameter ini NULL, panggilan balik dijalankan di lingkungan panggilan balik default. Untuk informasi selengkapnya, lihat InitializeThreadpoolEnvironment.

Menampilkan nilai

Jika fungsi berhasil, fungsi mengembalikan penunjuk ke struktur TP_WAIT yang menentukan objek tunggu. Aplikasi tidak mengubah anggota struktur ini.

Jika fungsi gagal, fungsi akan mengembalikan NULL. Untuk mengambil informasi kesalahan yang diperluas, panggil GetLastError.

Keterangan

Untuk mengatur objek tunggu, panggil fungsi SetThreadpoolWait atau SetThreadpoolWaitEx .

Item kerja dan semua fungsi yang dipanggilnya tidak boleh mengandalkan utas setelah kembali. Oleh karena itu, Anda tidak dapat memanggil panggilan asinkron yang memerlukan utas persisten, seperti fungsi RegNotifyChangeKeyValue tanpa bendera REG_NOTIFY_THREAD_AGNOSTIC , dari lingkungan panggilan balik default. Sebagai gantinya, gunakan utas yang masa pakainya Anda kontrol.

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

Contoh

Misalnya, lihat Menggunakan Fungsi Kumpulan Utas.

Persyaratan


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