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 |