CreateThreadpoolWork 函式 (threadpoolapiset.h)
建立新的工作物件。
語法
PTP_WORK CreateThreadpoolWork(
[in] PTP_WORK_CALLBACK pfnwk,
[in, out, optional] PVOID pv,
[in, optional] PTP_CALLBACK_ENVIRON pcbe
);
參數
[in] pfnwk
回呼函式。 每次呼叫 SubmitThreadpoolWork 以張貼工作物件時，背景工作線程都會呼叫此回呼。 如需詳細資訊，請參閱 WorkCallback。
[in, out, optional] pv
要傳遞至回呼函式的選擇性應用程式定義數據。
[in, optional] pcbe
定義執行回呼之環境 之TP_CALLBACK_ENVIRON 結構的指標。 在呼叫此函式之前，請使用 InitializeThreadpoolEnvironment 函式來初始化 結構。
如果此參數為 NULL，則回呼會在預設回呼環境中執行。 如需詳細資訊，請參閱 InitializeThreadpoolEnvironment。
傳回值
如果函式成功，它會傳回定義工作物件 之TP_WORK 結構的指標。 應用程式不會修改這個結構的成員。
如果函式失敗，它會傳回NULL。 若要擷取擴充的錯誤資訊，請呼叫 GetLastError。
備註
若要編譯使用此函式的應用程式，請將_WIN32_WINNT定義為0x0600或更高版本。
範例
如需範例，請參閱 使用線程集區函式。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | threadpoolapiset.h (包含 Windows.h) |
| 程式庫 | Kernel32.lib |
| DLL | Kernel32.dll |