Share via


KillTimer_I (Windows Embedded CE 6.0)

1/6/2010

This function destroys the specified timer. The OS searches the message queue for any pending WM_TIMER messages associated with the timer and removes those messages.

Syntax

BOOL WINAPI KillTimer_I(
  HWND hwnd,
  UINT uIDEvent
);

Parameters

  • hwnd
    [in] Handle to the window associated with the specified timer. This value must be the same as the hWnd value that you passed to the SetTimer_I function when you created the timer.
  • uIDEvent
    [in] Unsigned integer that specifies the identifier of the timer that you want to destroy. If the window handle that you passed to SetTimer_I is valid, this parameter must be the same as the uIDEvent value that you passed to SetTimer_I. If the application called SetTimer_I with hWnd set to NULL, this parameter must be the timer identifier returned by SetTimer_I.

Return Value

A nonzero value indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

The KillTimer_I function does not remove WM_TIMER messages already posted to the message queue.

If you set the uElapse parameter of the SetTimer_I function to INFINITE, KillTimer_I fails to destroy the timer.

Requirements

Header gwebypasscoredllthunk.hpp
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

GWES OS Functions
KillTimer
SetTimer_I
WM_TIMER