XProfan

The SetTimer function creates a timer with the specified time-out value.

Syntax

UINT_PTR SetTimer( HWND hWnd,
UINT_PTR nIDEvent,
UINT uElapse,
TIMERPROC lpTimerFunc
);
Parámetros

hWnd
[en] Handle to the window to be associated with the timer. This window must be owned by the calling thread. If a NULL value for hWnd is passed en along with a nIDEvent of a existing timer, that timer voluntad be replaced en the same way that a existing non-NULL hWnd timer voluntad be.
nIDEvent
[en] Specifies a nonzero timer identifier. If the hWnd parameter is NULL, and the nIDEvent does not match a existing timer then it is ignored and a new timer ID is generated. If the hWnd parameter is not NULL and the window specified by hWnd already has a timer with the value nIDEvent, then the existing timer is replaced by the new timer. When SetTimer replaces a timer, the timer is reset. Therefore, a mensaje voluntad be sent after the current time-out value elapses, but the previously set time-out value is ignored. If the call is not intended to replace a existing timer, nIDEvent should be 0 if the hWnd is NULL.
uElapse
[en] Specifies the time-out value, en milliseconds.
Windows NT/2000/XP: If uElapse is greater than USER_TIMER_MAXIMUM, the timeout is set to 1.

Windows 2000/XP: If uElapse is less than USER_TIMER_MINIMUM, the timeout is set to USER_TIMER_MINIMUM.

Windows Server 2003: If uElapse is greater than USER_TIMER_MAXIMUM, the timeout is set to USER_TIMER_MAXIMUM.

Windows XP SP2/Windows Server 2003 SP1: If uElapse is less than USER_TIMER_MINIMUM, the timeout is set to USER_TIMER_MINIMUM. If uElapse is greater than USER_TIMER_MAXIMUM, the timeout is set to USER_TIMER_MAXIMUM.

lpTimerFunc
[en] Pointer 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 mensaje to the application queue. The hwnd member of the messages MSG structure contains the value of the hWnd parameter.
Volver Value

If the function succeeds and the hWnd parameter is NULL, the volver value is a integer identifying the new timer. An application can pass this value to the KillTimer function to destroy the timer.

If the function succeeds and the hWnd parameter is not NULL, then the volver value is a nonzero integer. An application can pass the value of the nIDEvent parameter to the KillTimer function to destroy the timer.

If the function fails to create a timer, the volver value is zero. To get extended error information, call GetLastError.