CreateThreadpoolCleanupGroup-Funktion (threadpoolapiset.h)

  • Artikel

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

CloseThreadpoolCleanupGroup

Closethreadpoolcleanupgroupmembers

SetThreadpoolCallbackCleanupGroup

Threadpools