Share via

Функция 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 сообщений, уже опубликованных в очереди сообщений.

Примеры

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

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll
Набор API ext-ms-win-ntuser-window-l1-1-2 (представлено в Windows 10 версии 10.0.10240)

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

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

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

SetTimer

Таймеры

WM_TIMER