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 函数取消计时器或使用 ChangeTimerQueueTimer 重置。
返回值
如果该函数成功，则返回值为非零值。
如果函数失败，则返回值为零。 要获得更多的错误信息，请调用 GetLastError。
注解
当线程使用模拟时，无法调用此函数。 生成的行为未定义。
可以在计时器回调中调用 ChangeTimerQueueTimer 。
如果在一次性计时器上调用 ChangeTimerQueueTimer ， (其周期为零) 已过期，则不会更新计时器。
请勿在句柄上调用 DeleteTimerQueueTimer 后调用 ChangeTimerQueueTimer 。
若要编译使用此函数的应用程序， 请将_WIN32_WINNT 定义为 0x0500 或更高版本。 有关详细信息，请参阅 使用 Windows 标头。
要求
| 最低受支持的客户端 | Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | threadpoollegacyapiset.h |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |