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 标头。