CreateThreadpoolCleanupGroup 函式 (threadpoolapiset.h)

建立應用程式可用來追蹤一或多個線程集區回呼的清除群組。

Syntax

PTP_CLEANUP_GROUP CreateThreadpoolCleanupGroup();

傳回值

如果函式成功,它會傳回新配置清除群組 TP_CLEANUP_GROUP 結構的指標。 應用程式不會修改這個結構的成員。

如果函式失敗,它會傳回NULL。 若要擷取擴充的錯誤資訊,請呼叫 GetLastError

備註

建立清除群組之後,請呼叫 SetThreadpoolCallbackCleanupGroup ,將清除群組與回呼環境產生關聯。

每次呼叫下列其中一個函式時,成員都會新增至群組:

您可以使用下列其中一個對應的 close 函式,從群組中移除成員。

若要關閉所有回呼,請呼叫 CloseThreadpoolCleanupGroupMembers

若要編譯使用此函式的應用程式,請將_WIN32_WINNT定義為0x0600或更高版本。

範例

如需範例,請參閱 使用線程集區函式

規格需求

需求
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 threadpoolapiset.h (Windows 7、Windows Server 2008 Windows Server 2008 R2)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

CloseThreadpoolCleanupGroup

CloseThreadpoolCleanupGroupMembers

SetThreadpoolCallbackCleanupGroup

線程集區