Funzione CreateThreadpoolCleanupGroup (threadpoolapiset.h)

Crea un gruppo di pulizia che le applicazioni possono usare per tenere traccia di uno o più callback del pool di thread.

Sintassi

PTP_CLEANUP_GROUP CreateThreadpoolCleanupGroup();

Valore restituito

Se la funzione ha esito positivo, restituisce un puntatore a una struttura TP_CLEANUP_GROUP del gruppo di pulizia appena allocato. Le applicazioni non modificano i membri di questa struttura.

Se la funzione ha esito negativo, restituisce NULL. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Commenti

Dopo aver creato il gruppo di pulizia, chiamare SetThreadpoolCallbackCleanupGroup per associare il gruppo di pulizia a un ambiente di callback.

Un membro viene aggiunto al gruppo ogni volta che si chiama una delle funzioni seguenti:

Si usa una delle funzioni di chiusura corrispondenti seguenti per rimuovere un membro dal gruppo.

Per chiudere tutti i callback, chiamare CloseThreadpoolCleanupGroupMembers.

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0600 o versione successiva.

Esempio

Per un esempio, vedere Uso delle funzioni del pool di thread.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione threadpoolapiset.h (includere Windows.h in Windows 7, Windows Server 2008 Windows Server 2008 R2)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

CloseThreadpoolCleanupGroup

Closethreadpoolcleanupgroupmembers

SetThreadpoolCallbackCleanupGroup

Pool di thread