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

Статья
08/26/2023

Удаляет очередь таймера. Все ожидающие таймеры в очереди отменяются и удаляются.

Синтаксис

BOOL DeleteTimerQueueEx(
  [in]           HANDLE TimerQueue,
  [in, optional] HANDLE CompletionEvent
);

Параметры

[in] TimerQueue

Дескриптор очереди таймера. Этот дескриптор возвращается функцией CreateTimerQueue .

[in, optional] CompletionEvent

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

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

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

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

Если функция выполняется успешно, возвращается ненулевое значение.

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

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

Требования

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