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

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

Синтаксис

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 или выше.

Примеры

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

Требования

См. также

CreateThreadpoolWait

SetThreadpoolWait

SetThreadpoolWaitEx

Пулы потоков

WaitForThreadpoolWaitCallbacks