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


Функция CreateTimerQueue (threadpoollegacyapiset.h)

Создает очередь для таймеров. Таймеры очереди таймеров — это упрощенные объекты, позволяющие указать функцию обратного вызова для вызова в указанное время.

Синтаксис

HANDLE CreateTimerQueue();

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

Если функция выполняется успешно, возвращаемое значение будет дескриптором очереди таймера. Этот дескриптор можно использовать только в функциях, которым требуется дескриптор очереди таймера.

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

Комментарии

Чтобы добавить таймер в очередь, вызовите функцию CreateTimerQueueTimer . Чтобы удалить таймер из очереди, вызовите функцию DeleteTimerQueueTimer .

Завершив работу с очередью таймеров, вызовите функцию DeleteTimerQueueEx , чтобы удалить очередь таймера. Все ожидающие таймеры в очереди отменяются и удаляются.

Чтобы скомпилировать приложение, использующее эту функцию, определите _WIN32_WINNT как 0x0500 или более поздней версии. Дополнительные сведения см. в разделе Использование заголовков Windows.

Примеры

Пример использования CreateTimerQueue см. в разделе Использование очередей таймера.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header threadpoollegacyapiset.h
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

CreateTimerQueueTimer

DeleteTimerQueueEx

DeleteTimerQueueTimer

Функции синхронизации

Группировка потоков в пул

Очереди таймеров