XProfan

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

Syntax

UINT_PTR SetTimer( HWND hWnd,
UINT_PTR nIDEvent,
UINT uElapse,
TIMERPROC lpTimerFunc
);
Paramètres

hWnd
[dans] Handle to le window to être associated with le timer. This window must être owned by le calling thread. Si a NULL value for hWnd is passed dans along with à nIDEvent of à existing timer, that timer veux être replaced dans le same way that à existing non-NULL hWnd timer veux être.
nIDEvent
[dans] Specifies a nonzero timer identifier. Si le hWnd paramètre is NULL, and le nIDEvent does not match à existing timer then il is ignored and a new timer ID is generated. Si le hWnd paramètre is not NULL and le window specified by hWnd already has a timer with le value nIDEvent, then le existing timer is replaced by le new timer. When SetTimer replaces a timer, le timer is reset. Therefore, a message veux être sent after le current time-out value elapses, but le previously set time-out value is ignored. Si le call is not intended to replace à existing timer, nIDEvent should être 0 si le hWnd is NULL.
uElapse
[dans] Specifies le time-out value, dans milliseconds.
Windows NT/2000/XP: Si uElapse is greater than USER_TIMER_MAXIMUM, le timeout is set to 1.

Windows 2000/XP: Si uElapse is less than USER_TIMER_MINIMUM, le timeout is set to USER_TIMER_MINIMUM.

Windows Server 2003: Si uElapse is greater than USER_TIMER_MAXIMUM, le timeout is set to USER_TIMER_MAXIMUM.

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

lpTimerFunc
[dans] Pointer to le function to être notified when le time-out value elapses. For more information about le function, lac TimerProc. Si lpTimerFunc is NULL, le system posts a WM_TIMER message to le application queue. The hwnd member of le messages MSG structure contains le value of le hWnd paramètre.
Retour Value

Si le function succeeds and le hWnd paramètre is NULL, le return value is à integer identifying le new timer. à application can pass this value to le KillTimer function to destroy le timer.

Si le function succeeds and le hWnd paramètre is not NULL, then le return value is a nonzero integer. à application can pass le value of le nIDEvent paramètre to le KillTimer function to destroy le timer.

Si le function fails to create a timer, le return value is zero. To get extended error information, call GetLastError.