ChangeTimerQueueTimer

CreateTimerQueueTimer 関数で作成されたタイマキュータイマを更新する。

ChangeTimerQueueTimer TimerQueue, Timer, DueTime, Period

TimerQueue : [intptr] タイマキューへのハンドル。このハンドルは CreateTimerQueue 関数が返す。
Timer : [intptr] タイマキュータイマへのハンドル。このハンドルは CreateTimerQueueTimer 関数が返す。
DueTime : [int] タイマが満了するまでの時間（ミリ秒単位）。
Period : [int] タイマの周期（ミリ秒単位）。このパラメータがゼロの場合、タイマは 1 度だけシグナルされる。ゼロより大きい場合、タイマは周期タイマとなる。周期タイマは、DeleteTimerQueueTimer 関数でキャンセルされるか ChangeTimerQueueTimer でリセットされるまで、周期が経過するたびに自動的に再有効化される。

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

解説

CreateTimerQueueTimer 関数で作成されたタイマキュータイマを更新する。

[戻り値]
関数が成功した場合、戻り値はゼロ以外。関数が失敗した場合、戻り値はゼロ。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
この関数は、スレッドが impersonation
を使用している間に呼び出してはならない。その結果の動作は未定義である。タイマコールバック内で ChangeTimerQueueTimer
を呼ぶことができる。期間がゼロ（ワンショット）で既に満了したタイマに対して ChangeTimerQueueTimer
を呼んでも、タイマは更新されない。あるハンドルに対して DeleteTimerQueueTimer を呼んだ後に
ChangeTimerQueueTimer
を呼んではならない。この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNT を 0x0500
以降として定義する。詳細は Using the Windows Headers を参照。

情報