CreateTimerQueue 関数 (threadpoollegacyapiset.h)

タイマーのキューを作成します。タイマーキュータイマーは、指定した時刻に呼び出されるコールバック関数を指定できる軽量オブジェクトです。

構文

HANDLE CreateTimerQueue();

関数が成功した場合、戻り値はタイマーキューへのハンドルです。このハンドルは、タイマーキューへのハンドルを必要とする関数でのみ使用できます。

関数が失敗した場合は、返される値は NULL です。詳細なエラー情報を得るには、GetLastError を呼び出します。

キューにタイマーを追加するには、 CreateTimerQueueTimer 関数を呼び出します。キューからタイマーを削除するには、 DeleteTimerQueueTimer 関数を呼び出します。

タイマーのキューが終了したら、 DeleteTimerQueueEx 関数を呼び出してタイマーキューを削除します。キュー内の保留中のタイマーはすべて取り消され、削除されます。

この関数を使用するアプリケーションをコンパイルするには、 _WIN32_WINNT を 0x0500 以降として定義します。詳細については、「 Windows ヘッダーの使用」を参照してください。

CreateTimerQueue を使用する例については、「タイマーキューの使用」を参照してください。