指定されたタイマを破棄します。

BOOL KillTimer(
  HWND hWnd,          // ウィンドウのハンドル
  UINT_PTR uIDEvent   // タイマの識別子
);

パラメータ

hWnd

タイマに関連付けられているウィンドウのハンドルを指定します。SetTimer 関数で指定した hWnd パラメータと同じ値を指定しなければなりません。

uIDEvent

破棄するべきタイマを指定します。SetTimer 関数の hWnd パラメータで有効なウィンドウハンドルを指定した場合、SetTimer 関数の uIDEvent パラメータで指定したのと同じ値を、KillTimer 関数の uIDEvent パラメータでも指定しなければなりません。SetTimer 関数の hWnd パラメータで NULL を指定した場合、SetTimer 関数が返したタイマの識別子を指定しなければなりません。

戻り値

関数が成功すると、0 以外の値が返ります。

関数が失敗すると、0 が返ります。拡張エラー情報を取得するには、 関数を使います。

解説

KillTimer 関数は、既にメッセージキューに入っている メッセージを削除しません。

対応情報

Windows NT/2000：Windows NT 3.1 以降
Windows 95/98：Windows 95 以降
ヘッダー：Winuser.h 内で宣言、Windows.h をインクルード
インポートライブラリ：User32.lib を使用

参照

SetTimer,