CreateThreadpoolCleanupGroup-Funktion (threadpoolapiset.h)
Erstellt eine Bereinigungsgruppe, mit der Anwendungen einen oder mehrere Threadpoolrückrufe nachverfolgen können.
Syntax
PTP_CLEANUP_GROUP CreateThreadpoolCleanupGroup();
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt sie einen Zeiger auf eine TP_CLEANUP_GROUP Struktur der neu zugeordneten Bereinigungsgruppe zurück. Anwendungen ändern die Member dieser Struktur nicht.
Wenn die Funktion fehlschlägt, wird NULL zurückgegeben. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.
Hinweise
Rufen Sie nach dem Erstellen der Bereinigungsgruppe SetThreadpoolCallbackCleanupGroup auf, um die Bereinigungsgruppe einer Rückrufumgebung zuzuordnen.
Jedes Mal, wenn Sie eine der folgenden Funktionen aufrufen, wird der Gruppe ein Mitglied hinzugefügt:
Sie verwenden eine der folgenden entsprechenden Close-Funktionen, um ein Mitglied aus der Gruppe zu entfernen.
Um alle Rückrufe zu schließen, rufen Sie CloseThreadpoolCleanupGroupMembers auf.
Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0600 oder höher.
Beispiele
Ein Beispiel finden Sie unter Verwenden der Threadpoolfunktionen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | threadpoolapiset.h (Einschließen von Windows.h unter Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |
Siehe auch
Closethreadpoolcleanupgroupmembers