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 で導入) |
関連項目
概念
リファレンス