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

Статья
08/26/2023

Обновления таймер очереди таймера, созданный функцией 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.

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

Требования


Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	threadpoollegacyapiset.h
Библиотека	Kernel32.lib
DLL	Kernel32.dll