Fungsi CreateThreadpoolWork (threadpoolapiset.h)
Membuat objek kerja baru.
Sintaks
PTP_WORK CreateThreadpoolWork(
[in] PTP_WORK_CALLBACK pfnwk,
[in, out, optional] PVOID pv,
[in, optional] PTP_CALLBACK_ENVIRON pcbe
);
Parameter
[in] pfnwk
Fungsi panggilan balik. Utas pekerja memanggil panggilan balik ini setiap kali Anda memanggil SubmitThreadpoolWork untuk memposting objek kerja. Untuk detailnya, lihat WorkCallback.
[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 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 mengembalikan penunjuk ke struktur TP_WORK yang menentukan objek kerja. Aplikasi tidak mengubah anggota struktur ini.
Jika fungsi gagal, fungsi akan mengembalikan NULL. Untuk mengambil informasi kesalahan yang diperluas, panggil GetLastError.
Keterangan
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) |
Pustaka | Kernel32.lib |
DLL | Kernel32.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk