Fungsi TrySubmitThreadpoolCallback (threadpoolapiset.h)

Artikel
03/02/2024

Meminta agar utas pekerja kumpulan utas memanggil fungsi panggilan balik yang ditentukan.

Sintaks

BOOL TrySubmitThreadpoolCallback(
  [in]                PTP_SIMPLE_CALLBACK  pfns,
  [in, out, optional] PVOID                pv,
  [in, optional]      PTP_CALLBACK_ENVIRON pcbe
);

Parameter

[in] pfns

Fungsi panggilan balik. Untuk detailnya, lihat SimpleCallback.

[in, out, optional] pv

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

[in, optional] pcbe

Penunjuk ke struktur TP_CALLBACK_ENVIRON yang menentukan lingkungan untuk menjalankan fungsi panggilan balik. Gunakan fungsi InitializeThreadpoolEnvironment untuk menginisialisasi struktur sebelum memanggil fungsi ini.

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

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan TRUE.

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

Keterangan

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

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