KillTimer

Syntax

BOOL KillTimer(hWnd,nIDEvent)

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.

Parameter Type/Description  

hWnd 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 int 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.