Функция ChangeTimerQueueTimer (threadpoollegacyapiset.h)

Обновления таймер очереди таймера, созданный функцией CreateTimerQueueTimer.

Синтаксис

BOOL ChangeTimerQueueTimer(
  [in, optional] HANDLE TimerQueue,
  [in, out]      HANDLE Timer,
  [in]           ULONG  DueTime,
  [in]           ULONG  Period
);

Параметры

[in, optional] TimerQueue

Дескриптор очереди таймера. Этот дескриптор возвращается функцией CreateTimerQueue .

Если этот параметр имеет значение NULL, таймер связан с очередью таймера по умолчанию.

[in, out] Timer

Дескриптор таймера очереди. Этот дескриптор возвращается функцией CreateTimerQueueTimer .

[in] DueTime

Время истечения срока действия таймера в миллисекундах.

[in] Period

Период таймера в миллисекундах. Если этот параметр равен нулю, таймер получает сигнал один раз. Если этот параметр больше нуля, таймер является периодическим. Периодический таймер автоматически активируется каждый раз, когда истекает период, пока таймер не будет отменен с помощью функции DeleteTimerQueueTimer или сброс с помощью ChangeTimerQueueTimerTimer.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Эту функцию нельзя вызвать, когда поток использует олицетворение. Результирующее поведение не определено.

Вы можете вызвать ChangeTimerQueueTimer в обратном вызове таймера.

Если вы вызываете ChangeTimerQueueTimer для одноразового таймера (его период равен нулю), срок действия которого уже истек, таймер не обновляется.

Не вызывайте ChangeTimerQueueTimer после вызова Метода DeleteTimerQueueTimer для дескриптора.

Чтобы скомпилировать приложение, использующее эту функцию, определите _WIN32_WINNT как 0x0500 или более поздней версии. Дополнительные сведения см. в разделе Использование заголовков Windows.

Требования

См. также

CreateTimerQueue

CreateTimerQueueTimer

DeleteTimerQueueTimer

Функции синхронизации

Группировка потоков в пул

Очереди таймера