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

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

Синтаксис

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

Параметры

[in] TimerQueue

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

[in, optional] CompletionEvent

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

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

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

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

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

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

Комментарии

Не блокируя вызовы DeleteTimerQueueEx из обратного вызова таймера.

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

Требования

См. также

CreateTimerQueue

DeleteTimerQueueTimer

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

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

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