Функция KillTimer ликвидирует указанный таймер.
BOOL KillTimer( HWND hWnd, UINT_PTR uIDEvent ); |
[in] Дескриптор окна, связанного с указанным таймером. Это значение должно быть таким же, как и значение hWnd, переданное в функцию SetTimer, которая создала таймер.
uIDEvent[in] Указывает таймер, который будет ликвидирован. Если дескриптор окна, который передают в функцию SetTimer - правильный, то этот параметр должен быть таким же, как и значение nIDEvent переданное в SetTimer. Если приложение вызывает SetTimer с hWnd установленным в NULL, то этот параметр должен быть идентификатором таймера, значение которого возвращает функция SetTimer.
Если функция завершается успешно, возвращаемое значение - не нуль.
Если функция завершается ошибкой, возвращаемое значение - нуль. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Функция KillTimer не удаляет объявленные сообщения WM_TIMER, которые уже поставлены в очередь сообщений.
Пример смотри в статье Ликвидация таймера.
Обзор Таймеры, Функции, используемые таймером, SetTimer, WM_TIMER
Размещение и совместимость KillTimer |
||
| К | Windows XP | Да |
| л | Windows 2000 Professional | Да |
| и | Windows NT Workstation | Да версии 3.1 |
| е | Windows Me | Да |
| н | Windows 98 | Да |
| т | Windows 95 | Да |
| С | Windows Server 2003 | Да |
| е | Windows 2000 Server | Да |
| р | Windows NT Server | Да версии 3.1 |
| в | ||
| е | ||
| р | ||
| Используемая библиотека | User32.lib | |
| Используемая DLL | user32.dll | |
| Заголовочный файл | ||
| - объявлено в | Winuser.h | |
| - включено в | Windows.h | |
| Unicode | Нет | |
| Замечания по платформе | Не имеется | |