DosCloseQueue

Ends access to a queue, or deletes a queue.

Syntax
DosCloseQueue (hq)

Parameters

 * hq (HQUEUE) - input : The handle of the queue to be closed.
 * This is the handle received from a previous call to DosCreateQueue or DosOpenQueue.


 * ulrc (APIRET) - returns:Return Code.
 * DosCloseQueue returns one of the following values:


 * 0 NO_ERROR
 * 337 ERROR_QUE_INVALID_HANDLE

Remarks
DosCloseQueue ends further processing of a queue by the requesting process. The action taken depends on whether the requester is the owner of the queue or a writer of the queue.

For the owner, any outstanding elements are deleted. Other processes that have the queue open will receive the ERROR_QUE_INVALID_HANDLE return code on their next request.

For a writer of the queue, access to the queue is ended, but the queue elements are not deleted.

Related Functions

 * DosCreateQueue
 * DosOpenQueue
 * DosPeekQueue
 * DosPurgeQueue
 * DosQueryQueue
 * DosReadQueue
 * DosWriteQueue