deleteTimerQueueEx 函数 (threadpoollegacyapiset.h)
删除计时器队列。 队列中任何挂起的计时器都将被取消和删除。
语法
BOOL DeleteTimerQueueEx(
[in] HANDLE TimerQueue,
[in, optional] HANDLE CompletionEvent
);
参数
[in] TimerQueue
计时器队列的句柄。 此句柄由 CreateTimerQueue 函数返回。
[in, optional] CompletionEvent
函数成功且所有回调函数已完成时要发出信号的事件对象的句柄。 此参数可以为 NULL。
如果此参数 INVALID_HANDLE_VALUE,则函数将等待所有回调函数完成,然后再返回。
如果此参数为 NULL,则该函数将计时器标记为删除并立即返回。 但是,大多数调用方应等待回调函数完成,以便可以执行任何所需的清理。
返回值
如果该函数成功,则返回值为非零值。
如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。
注解
请勿在计时器回调中对 DeleteTimerQueueEx 进行阻止调用。
若要编译使用此函数的应用程序, 请将_WIN32_WINNT 定义为 0x0500 或更高版本。 有关详细信息,请参阅 使用 Windows 标头。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | threadpoollegacyapiset.h |
Library | Kernel32.lib |
DLL | Kernel32.dll |