windows_programming_notes.nbk: Home | Index | Next Page: LineTo | Previous Page: IsWindowVisible

 KillTimer

The KillTimer function destroys the specified timer.

Syntax

    BOOL KillTimer(
        HWND hWnd,
        UINT_PTR uIDEvent
    );

Parameters

• hWnd
  [in] Handle to the window associated with the specified timer. This value must be the same as the hWnd value passed to the SetTimer function that created the timer.
• uIDEvent
  [in] Specifies the timer to be destroyed. If the window handle passed to SetTimer is valid, this parameter must be the same as the nIDEvent value passed to SetTimer. If the application calls SetTimer with hWnd set to NULL, this parameter must be the timer identifier returned by SetTimer.

Return Value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

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

Function Information

• Minimum DLL Version user32.dll
• Header Declared in Winuser.h, include Windows.h
• Import library User32.lib
• Minimum operating systems Windows 95, Windows NT 3.1
• Unicode Implemented as Unicode version.

windows_programming_notes.nbk: Home | Index | Next Page: LineTo | Previous Page: IsWindowVisible

Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time