DosOpenQueue (OS/2 1.x)

This call opens a queue for the current process.

Syntax
DosOpenQueue (OwnerPID, QueueHandle, QueueName)

Parameters

 * 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.

Return Code

 * 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\.

C

 * 1) define INCL_DOSQUEUES

USHORT rc = DosOpenQueue(OwnerPID, QueueHandle, QueueName);

PUSHORT OwnerPID;     /* Address to put queue owners' PID */ PHQUEUE QueueHandle;  /* Address to put handle of queue */ PSZ    QueueName;     /* Pointer to queue name string */

USHORT rc;            /* return code */ 

MASM
 EXTRN DosOpenQueue:FAR INCL_DOSQUEUES     EQU 1

PUSH@ WORD    OwnerPID      ;Queue owners' PID (returned) PUSH@ WORD    QueueHandle   ;Queue handle (returned) PUSH@ ASCIIZ  QueueName     ;Queue name string CALL  DosOpenQueue

Returns WORD 