DosOpenQueue

Bindings:  C, MASM 

This call opens a queue for the current process. 

 DosOpenQueue      (OwnerPID, QueueHandle, QueueName) 
 

 OwnerPID (PUSHORT) - output 
    Address of the process ID of the queue owner. 

 QueueHandle (PHQUEUE) - output 
    Address of the write handle of the queue. 

 QueueName (PSZ) - input 
    Address of the name of the queue provided by a previous DosCreateQueue 
    call. 

 rc (USHORT) - return 
    Return code descriptions are: 

    0         NO_ERROR 
    334       ERROR_QUE_NO_MEMORY 
    343       ERROR_QUE_NAME_NOT_EXIST 
 
 Remarks 

 A process that creates a queue has access to it with the handle returned 
 by DosCreateQueue.  Before another process can place elements in the 
 queue with DosWriteQueue, the process must first obtain the queue handle 
 by issuing DosOpenQueue. 

 When specifying the name for the queue, the ASCIIZ name string provided 
 must include the prefix \QUEUES\.