DosPurgeQueue

Bindings:  C, MASM 

This call purges a queue of all elements. 

 DosPurgeQueue     (QueueHandle) 
 

 QueueHandle (HQUEUE) - input 
    Handle of the queue to purge. 

 rc (USHORT) - return 
    Return code descriptions are: 

    0         NO_ERROR 
    330       ERROR_QUE_PROC_NOT_OWNED 
    337       ERROR_QUE_INVALID_HANDLE 
 
 Remarks 

 A process that creates a queue with DosCreateQueue owns it. Only the 
 owning process and any threads it creates can issue DosPurgeQueue to 
 remove all the elements from the queue.