DosOpenQueue (OS/2 1.x)

Description

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

Example Code

C Binding

#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 Binding

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