DosCloseQueue

Bindings:  C, MASM 

This call closes the queue in use by the requesting process. 

 DosCloseQueue (QueueHandle) 
 

 QueueHandle (HQUEUE) - input 
    Handle returned from a previous DosCreateQueue or DosOpenQueue call. 

 rc (USHORT) - return 
    Return code descriptions are: 

    0         NO_ERROR 
    337       ERROR_QUE_INVALID_HANDLE 
 
 Remarks 

 DosCloseQueue is used to terminate further processing of a queue by the 
 requesting process. The actions taken depend on whether the requestor is 
 the owner or a writer of the queue. For all processes, an access count 
 representing all DosOpenQueue calls performed is decremented. For 
 non-owning processes, access is terminated when this count goes to zero. 
 For owning processes, the queue (and its elements) are purged if the 
 access count previously equaled zero. Other processes that have the queue 
 open receive the ERROR_QUE_INVALID_HANDLE return code on their next 
 request.