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

  • Статья

Создает группу очистки, которую приложения могут использовать для отслеживания одного или нескольких обратных вызовов пула потоков.

Синтаксис

PTP_CLEANUP_GROUP CreateThreadpoolCleanupGroup();

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

Если функция завершается успешно, она возвращает указатель на TP_CLEANUP_GROUP структуру только что выделенной группы очистки. Приложения не изменяют члены этой структуры.

Если функция завершается сбоем, она возвращает значение NULL. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError.

Комментарии

После создания группы очистки вызовите Метод SetThreadpoolCallbackCleanupGroup , чтобы связать группу очистки со средой обратного вызова.

Член добавляется в группу при каждом вызове одной из следующих функций:

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

Чтобы закрыть все обратные вызовы, вызовите Метод CloseThreadpoolCleanupGroupMembers.

Чтобы скомпилировать приложение, использующее эту функцию, определите _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

См. также

CloseThreadpoolCleanupGroup

CloseThreadpoolCleanupGroupMembers

SetThreadpoolCallbackCleanupGroup

Пулы потоков