InitializeThreadpoolEnvironment 函式 (winbase.h)

初始化回呼環境。

語法

void InitializeThreadpoolEnvironment(
  [out] PTP_CALLBACK_ENVIRON pcbe
);

參數

[out] pcbe

定義回呼環境的 TP_CALLBACK_ENVIRON 結構。

傳回值

備註

根據預設,回呼會在進程的預設線程集區中執行。 沒有清除群組與回呼環境相關聯,呼叫端負責在有未處理的回呼時保留回呼的 DLL 載入,而且回呼預期會在應用程式的合理時間內執行。

如果您打算呼叫下列其中一個函式來修改環境,請建立回呼環境:

若要使用預設回呼環境,請在呼叫下列其中一個函式時,將選擇性回呼環境參數設定為 NULL: InitializeThreadpoolEnvironment 函式會實作為內嵌函式。

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

範例

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

規格需求

需求
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)

另請參閱

DestroyThreadpoolEnvironment

SetThreadpoolCallbackCleanupGroup

SetThreadpoolCallbackLibrary

SetThreadpoolCallbackPool

SetThreadpoolCallbackRunsLong

線程集區