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 函数取消计时器或使用 ChangeTimerQueueTimer 重置。

返回值

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。

注解

当线程使用模拟时，无法调用此函数。生成的行为未定义。

可以在计时器回调中调用 ChangeTimerQueueTimer 。

如果在一次性计时器上调用 ChangeTimerQueueTimer ， (其周期为零) 已过期，则不会更新计时器。

请勿在句柄上调用 DeleteTimerQueueTimer 后调用 ChangeTimerQueueTimer 。

若要编译使用此函数的应用程序， 请将_WIN32_WINNT 定义为 0x0500 或更高版本。有关详细信息，请参阅使用 Windows 标头。

要求


最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	threadpoollegacyapiset.h
Library	Kernel32.lib
DLL	Kernel32.dll