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

如果该函数成功,则返回值为非零值。

如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。

注解

KillTimer 函数不会删除已发布到消息队列WM_TIMER消息。

示例

有关示例,请参阅 销毁计时器

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll
API 集 在 Windows 10 版本 10.0.10240 中引入的 ext-ms-win-ntuser-window-l1-1-2 ()

请参阅

概念性

引用

SetTimer

计时器

WM_TIMER