CreateTimerQueue 函数 (threadpoollegacyapiset.h)
为计时器创建队列。 计时器队列计时器是轻型对象,可用于指定要在指定时间调用的回调函数。
语法
HANDLE CreateTimerQueue();
返回值
如果函数成功,则返回值是计时器队列的句柄。 此句柄只能在需要计时器队列句柄的函数中使用。
如果函数失败,则返回值为 NULL。 要获得更多的错误信息,请调用 GetLastError。
注解
若要将计时器添加到队列,请调用 CreateTimerQueueTimer 函数。 若要从队列中删除计时器,请调用 DeleteTimerQueueTimer 函数。
完成计时器队列后,调用 DeleteTimerQueueEx 函数以删除计时器队列。 队列中任何挂起的计时器都将被取消和删除。
若要编译使用此函数的应用程序, 请将_WIN32_WINNT 定义为 0x0500 或更高版本。 有关详细信息,请参阅 使用 Windows 标头。
示例
有关使用 CreateTimerQueue 的示例,请参阅 使用计时器队列。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | threadpoollegacyapiset.h |
Library | Kernel32.lib |
DLL | Kernel32.dll |