CreateThreadpoolWait

新しい待機オブジェクトを作成する。

CreateThreadpoolWait pfnwa, pv, pcbe

pfnwa : [int] 待機が完了またはタイムアウトしたときに呼ばれるコールバック関数。詳細は WaitCallback を参照。
pv : [intptr] コールバック関数に渡す省略可能なアプリケーション定義データ。
pcbe : [var] コールバックを実行する環境を定義する TP_CALLBACK_ENVIRON 構造体。InitializeThreadpoolEnvironment 関数がこの構造体を返す。このパラメータが NULL の場合、コールバックは既定のコールバック環境で実行される。詳細は InitializeThreadpoolEnvironment を参照。

(プラグイン / モジュール : kernel32.dll)

解説

新しい待機オブジェクトを作成する。

[戻り値]
関数が成功した場合、待機オブジェクトを定義する TP_WAIT
構造体へのポインタを返す。アプリケーションはこの構造体のメンバーを変更してはならない。関数が失敗した場合は NULL
を返す。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
待機オブジェクトを設定するには SetThreadpoolWait または SetThreadpoolWaitEx
関数を呼ぶ。作業項目とそれが呼ぶ関数は、戻った後にスレッドに依存してはならない。したがって、REG_NOTIFY_THREAD_AGNOSTIC
フラグなしの RegNotifyChangeKeyValue
関数のような永続的なスレッドを必要とする非同期呼び出しを既定のコールバック環境から呼ぶことはできない。代わりに、寿命を自分で制御するスレッドを使う。この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNT
を 0x0600 以降として定義する。

情報