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 |