共用方式為


CreateThreadpool 函式 (threadpoolapiset.h)

配置線程的新集區以執行回呼。

語法

PTP_POOL CreateThreadpool(
  PVOID reserved
);

參數

reserved

此參數是保留的,而且必須是 NULL。

傳回值

如果函式成功,它會傳回代表新配置線程集區 之TP_POOL 結構的指標。 應用程式不會修改這個結構的成員。

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

備註

建立新的線程集區之後,您應該呼叫 SetThreadpoolThreadMaximum 來指定集區可以配置的最大線程 數目,並 指定集區中可用的線程數目下限。

若要使用集區,您必須將集區與回呼環境產生關聯。 若要建立回呼環境,請呼叫 InitializeThreadpoolEnvironment。 然後,呼叫 SetThreadpoolCallbackPool ,將集區與回呼環境建立關聯。

若要釋放線程集區,請呼叫 CloseThreadpool

若要編譯使用此函式的應用程式,請將_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

另請參閱

CloseThreadpool

SetThreadpoolThreadMaximum

SetThreadpoolThreadMinimum

線程集區