closeThreadpoolWait 函数 (threadpoolapiset.h)
释放指定的等待对象。
语法
void CloseThreadpoolWait(
[in, out] PTP_WAIT pwa
);
参数
[in, out] pwa
指向定义 wait 对象的 TP_WAIT 结构的指针。 CreateThreadpoolWait 函数返回此指针。
返回值
无
备注
如果没有未完成的回调，则会立即释放等待对象;否则，计时器对象在完成未完成的回调后异步释放。
在某些情况下，回调函数可能会在调用 CloseThreadpoolWait 后运行。 为了防止这种行为发生，请执行以下操作：
- 调用 SetThreadpoolWait 函数或 SetThreadpoolWaitEx 函数，并将 h 参数设置为 NULL。
- 调用 WaitForThreadpoolWaitCallbacks 函数，并将 fCancelPendingCallbacks 参数设置为 TRUE。
- 调用 CloseThreadpoolWait。
如果存在与 wait 对象关联的清理组，则无需调用此函数;调用 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 |