Function name: SetTimer

Defined in : User32

Requirements : Windows NT 3.1 or later; Windows 95 or later

Declaration:

Declare Function SetTimer Lib "user32" Alias "SetTimer" (ByVal hWnd As Long, ByVal nIDEvent As Long, ByVal uElapse As Long, ByVal lpTimerFunc As Long) As Long

Parameters:

* hWnd Identifies the window to be associated with the timer. This window must be owned by the calling thread. If this parameter is NULL, no window is associated with the timer and the nIDEvent parameter is ignored. * nIDEvent Specifies a nonzero timer identifier. If the hWnd parameter is NULL, this parameter is ignored. * uElapse Specifies the time-out value, in milliseconds. * lpTimerFunc Points to the function to be notified when the time-out value elapses. For more information about the function, see TimerProc. If lpTimerFunc is NULL, the system posts a WM_TIMER message to the application queue. The hwnd member of the message’s MSG structure contains the value of the hWnd parameter.

Returns:

If the function succeeds, the return value is an integer identifying the new timer. An application can pass this value, or the string identifier, if it exists, to the KillTimer function to destroy the timer. If the function fails to create a timer, the return value is zero.

Related functions:

Examples:

Timer using SetTimer and KillTimer