Fungsi CreateThreadpoolCleanupGroup (threadpoolapiset.h)

Membuat grup pembersihan yang dapat digunakan aplikasi untuk melacak satu atau beberapa panggilan balik kumpulan utas.

Sintaks

PTP_CLEANUP_GROUP CreateThreadpoolCleanupGroup();

Mengembalikan nilai

Jika fungsi berhasil, fungsi mengembalikan pointer ke struktur TP_CLEANUP_GROUP dari grup pembersihan yang baru dialokasikan. Aplikasi tidak mengubah anggota struktur ini.

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

Keterangan

Setelah membuat grup pembersihan, panggil SetThreadpoolCallbackCleanupGroup untuk mengaitkan grup pembersihan dengan lingkungan panggilan balik.

Anggota ditambahkan ke grup setiap kali Anda memanggil salah satu fungsi berikut:

• CreateThreadpoolIo
• CreateThreadpoolTimer
• CreateThreadpoolWait
• CreateThreadpoolWork

Anda menggunakan salah satu fungsi tutup terkait berikut ini untuk menghapus anggota dari grup.

• CloseThreadpoolIo
• CloseThreadpoolTimer
• CloseThreadpoolWait
• CloseThreadpoolWork

Untuk menutup semua panggilan balik, panggil CloseThreadpoolCleanupGroupMembers.

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

Lihat juga

CloseThreadpoolCleanupGroup

CloseThreadpoolCleanupGroupMembers

SetThreadpoolCallbackCleanupGroup

Kumpulan Utas