DeleteTimerQueue

The DeleteTimerQueue function deletes a timer queue. Any pending timers in the queue are canceled and deleted.

To use a completion event, call the DeleteTimerQueueEx function.

BOOL DeleteTimerQueue(
  HANDLE TimerQueue,      // handle to timer queue
);

Parameters

TimerQueue

[in] Handle to a timer queue. This handle is returned by the CreateTimerQueue function.

If the timer was created using the default timer queue, this parameter should be NULL.

Return Values

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

DeleteTimerQueue does not wait for all callback functions associated with the timer to complete.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in Winbase.h; include Windows.h.
  Library: Use Kernel32.lib.

See Also

Synchronization Overview, Synchronization Functions, CreateTimerQueue, DeleteTimerQueueEx, DeleteTimerQueueTimer, Thread Pooling