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

另请参阅

CreateThreadpoolWait

SetThreadpoolWait

SetThreadpoolWaitEx

线程池

WaitForThreadpoolWaitCallbacks