KillTimer

  BOOL KillTimer(hwnd, nIDEvent)    
  HWND hwnd; /* handle of window that installed timer */
  UINT nIDEvent; /* timer identifier */

This function kills the timer event identified by the hwnd and nIDEvent parameters. Any pending WM_TIMER messages associated with the timer are removed from the message queue.

Parameters

hwnd

Identifies the window associated with the given timer event. This must be the same value passed as the hwnd parameter to the SetTimer function call that created the timer event.

nIDEvent

Specifies the timer event to be killed. If the application called SetTimer with the hwnd parameter set to NULL, this must be the event identifier returned by SetTimer. If the hwnd parameter of SetTimer was a valid window handle, nIDEvent must be the value of the nIDEvent parameter passed to SetTimer.

Return Value

The return value specifies the outcome of the function. It is nonzero if the event was killed. It is zero if the KillTimer function could not find the specified timer event.

See Also

SetTimer