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 的值。如果應用程式呼叫設定為 Null的SetTimer，此參數必須是SetTimer所傳回的計時器識別碼。

類型： BOOL

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

KillTimer 函式不會移除已張貼至訊息佇列WM_TIMER訊息。

如需範例，請參閱終結計時器。


最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-window-l1-1-2 (于 Windows 10 10.0.10240 版)

概念

參考