KillTimer 関数 (winuser.h)

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

構文

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

[in, optional] hWnd

型: HWND

指定したタイマーに関連付けられているウィンドウへのハンドル。この値は、タイマーを作成した SetTimer 関数に渡される hWnd 値と同じである必要があります。

[in] uIDEvent

種類: UINT_PTR

破棄されるタイマー。 SetTimer に渡されるウィンドウハンドルが有効な場合、このパラメーターは nIDEvent と同じである必要があります

SetTimer に渡される値。 アプリケーションが hWnd を NULL に設定して SetTimer を呼び出す場合、このパラメーターは SetTimer によって返されるタイマー識別子である必要があります。

種類: BOOL

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。詳細なエラー情報を得るには、GetLastError を呼び出します。

KillTimer 関数は、メッセージキューに既に投稿WM_TIMERメッセージを削除しません。

例については、「タイマーの破棄」を参照してください。


サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	winuser.h (Windows.h を含む)
Library	User32.lib
[DLL]	User32.dll
API セット	ext-ms-win-ntuser-window-l1-1-2 (Windows 10 バージョン 10.0.10240 で導入)