CreateTimerQueue function (threadpoollegacyapiset.h)

Creates a queue for timers. Timer-queue timers are lightweight objects that enable you to specify a callback function to be called at a specified time.

HANDLE CreateTimerQueue();

If the function succeeds, the return value is a handle to the timer queue. This handle can be used only in functions that require a handle to a timer queue.

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

To add a timer to the queue, call the CreateTimerQueueTimer function. To remove a timer from the queue, call the DeleteTimerQueueTimer function.

When you are finished with the queue of timers, call the DeleteTimerQueueEx function to delete the timer queue. Any pending timers in the queue are canceled and deleted.

To compile an application that uses this function, define _WIN32_WINNT as 0x0500 or later. For more information, see Using the Windows Headers.

For an example that uses CreateTimerQueue, see Using Timer Queues.

CreateTimerQueueTimer

DeleteTimerQueueEx

DeleteTimerQueueTimer

Synchronization Functions

Thread Pooling

Timer Queues