KillTimer

小甲鱼

注：本文档由 Diu 翻译，小甲鱼校对。

原文链接 -> 传送门

函数功能：

KillTimer 函数用于销毁指定定时器。


API 函数原型：

注释：_In_ 说明该参数是输入的，_opt_ 说明该参数是可选的。

BOOL WINAPI KillTimer(
  _In_opt_ HWND     hWnd,
  _In_     UINT_PTR uIDEvent
);

参数解析：

参数	含义
hWnd	1. 与定时器相关联的窗口的句柄 2. 该值必须与使用 SetTimer 函数来创建该定时器时传递的 hWnd 值相同
uIDEvent	1. 指定将被销毁的定时器 2. 如果传递给 SetTimer 函数的窗口句柄是有效的，那么该参数必须和传递给 SetTimer 的 nIDEvent 值相同 3. 如果应用程序调用 SetTimer 函数时，指定 hWnd 为 NULL，则该参数必须为 SetTimer 返回的标识符

返回值：

1. 如果函数调用成功，则返回值为非 0；

2. 如果函数调用失败，则返回值为 0；

获取有关错误的更多信息，请调用 GetLastError 函数。


备注：

KillTimer 函数不会移除已经提交到消息队列的 WM_TIMER 消息。


需求：

Minimum supported client	Windows 2000 专业版 [桌面应用程序]
Minimum supported server	Windows 2000 服务器版 [桌面应用程序]
Header	Winuser.h (包含于 Windows.h)
Library	User32.lib
DLL	User32.dll

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。