Поделиться через


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

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

Синтаксис

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

Параметры

[in, out] pwa

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

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

None

Remarks

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

В некоторых случаях функции обратного вызова могут выполняться после вызова 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

См. также

CreateThreadpoolWait

SetThreadpoolWait

SetThreadpoolWaitEx

Пулы потоков

WaitForThreadpoolWaitCallbacks