closeThreadpoolTimer 函数 (threadpoolapiset.h)

释放指定的计时器对象。

语法

void CloseThreadpoolTimer(
  [in, out] PTP_TIMER pti
);

[in, out] pti

指向定义计时器对象的 TP_TIMER 结构的指针。 CreateThreadpoolTimer 函数返回此指针。

无

如果没有未完成的回调，计时器对象将立即释放;否则，计时器对象在未完成的回调函数完成后异步释放。

在某些情况下，回调函数可能会在调用 CloseThreadpoolTimer 后运行。为了防止这种行为发生，请执行以下操作：

调用 SetThreadpoolTimer 函数或 SetThreadpoolTimerEx 函数，并将 pftDueTime 参数设置为 NULL， 并将 msPeriod 和 msWindowLength 参数设置为 0。
调用 WaitForThreadpoolTimerCallbacks 函数，并将 fCancelPendingCallbacks 参数设置为 TRUE。
调用 CloseThreadpoolTimer。

如果存在与计时器对象关联的清理组，则无需调用此函数;调用 CloseThreadpoolCleanupGroupMembers 函数将释放与清理组关联的工作、等待和计时器对象。

若要编译使用此函数的应用程序，请将_WIN32_WINNT定义为 0x0600 或更高版本。

要求	值
最低受支持的客户端	Windows Vista [桌面应用 \| UWP 应用]
最低受支持的服务器	Windows Server 2008 [桌面应用 \| UWP 应用]
目标平台	Windows
标头	threadpoolapiset.h (包括 Windows 7 上的 Windows.h、Windows Server 2008 Windows Server 2008 R2)
Library	Kernel32.lib
DLL	Kernel32.dll