Функция KillTimer (winuser.h)

Уничтожает указанный таймер.

Синтаксис

BOOL KillTimer(
  [in, optional] HWND     hWnd,
  [in]           UINT_PTR uIDEvent
);

Параметры

[in, optional] hWnd

Тип: HWND

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

[in] uIDEvent

Тип: UINT_PTR

Таймер, который необходимо уничтожить. Если дескриптор окна, переданный в SetTimer, является допустимым, этот параметр должен совпадать с параметром nIDEvent.

значение, переданное в SetTimer. Если приложение вызывает SetTimer с параметром hWnd со значением NULL, этот параметр должен быть идентификатором таймера, возвращенным SetTimer.

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

Тип: BOOL

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

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

Комментарии

Функция KillTimer не удаляет WM_TIMER сообщений, уже опубликованных в очереди сообщений.

Примеры

Пример см. в разделе Уничтожение таймера.

Требования

См. также раздел

Основные понятия

Справочные материалы

SetTimer

Таймеры

WM_TIMER