InitializeThreadpoolEnvironment 関数 (winbase.h)

[アーティクル]
03/03/2024

コールバック環境を初期化します。

構文

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 を含む)