Функция CloseThreadpoolWait (threadpoolapiset.h)

Статья
08/26/2023

Освобождает указанный объект ожидания.

Синтаксис

void CloseThreadpoolWait(
  [in, out] PTP_WAIT pwa
);

Параметры

[in, out] pwa

Указатель на структуру TP_WAIT , которая определяет объект ожидания. Функция CreateThreadpoolWait возвращает этот указатель.

Возвращаемое значение

None

Remarks

Объект wait освобождается немедленно, если нет невыполненных обратных вызовов; В противном случае объект таймера освобождается асинхронно после завершения невыполненных обратных вызовов.

В некоторых случаях функции обратного вызова могут выполняться после вызова CloseThreadpoolWait . Чтобы предотвратить это, сделайте следующее:

Вызовите функцию SetThreadpoolWait или SetThreadpoolWaitEx с параметром h , имеющим значение NULL.
Вызовите функцию WaitForThreadpoolWaitCallbacks с параметром fCancelPendingCallbacks , равным TRUE.
Вызовите CloseThreadpoolWait.

Если с объектом wait связана группа очистки, вызывать эту функцию не нужно; Вызов функции CloseThreadpoolCleanupGroupMembers освобождает объекты work, wait и timer, связанные с группой очистки.

Чтобы скомпилировать приложение, использующее эту функцию, определите _WIN32_WINNT как 0x0600 или выше.

Примеры

Пример см. в разделе Использование функций пула потоков.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	threadpoolapiset.h (включая Windows.h в Windows 7, Windows Server 2008 Windows Server 2008 R2)
Библиотека	Kernel32.lib
DLL	Kernel32.dll