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

另请参阅

CreateTimerQueueTimer

DeleteTimerQueueEx

DeleteTimerQueueTimer

同步函数

线程池

计时器队列