OS/2 Queue API Differences

The following describes the implementation differences between the OS2Linux library and the real OS/2 queue APIs.

These APIs are included in your application by including the following definition in your application source file.

#define INCL_DOSQUEUES

DosCreatePipe

APIRET APIENTRY DosCreatePipe(PHFILE phfRead, PHFILE phfWrite, ULONG cb);

• The argument cb is ignored.

DosCloseQueue

APIRET APIENTRY DosCloseQueue(HQUEUE hq);

• None.

DosCreateQueue

APIRET APIENTRY DosCreateQueue(PHQUEUE phq, ULONG queue_flags, PSZ pszName);

• The argument queue_flags is ignored.
• The queue is always a FIFO queue.

DosOpenQueue

APIRET APIENTRY DosOpenQueue(PPID ppid, PHQUEUE phq, PSZ pszName);

• None.

DosPeekQueue

APIRET APIENTRY DosPeekQueue(HQUEUE hq, PREQUESTDATA pRequest, PULONG pcbData,
                             PPVOID ppbuf, PULONG element, BOOL32 nowait,
                             PBYTE ppriority, HEV hsem);

• This function is not supported and always returns ERROR_ACCESS_DENIED.

DosPurgeQueue

APIRET APIENTRY DosPurgeQueue(HQUEUE hq);

• This function is not supported and always returns ERROR_ACCESS_DENIED.

DosQueryQueue

APIRET APIENTRY DosQueryQueue(HQUEUE hq, PULONG pcbEntries);

• This function is not supported and always returns ERROR_ACCESS_DENIED.

DosReadQueue

APIRET APIENTRY DosReadQueue(HQUEUE hq, PREQUESTDATA pRequest, PULONG pcbData,
                             PPVOID ppbuf, ULONG element, BOOL32 wait,
                             PBYTE ppriority, HEV hsem);

• The argument element is ignored.

DosWriteQueue

APIRET APIENTRY DosWriteQueue(HQUEUE hq, ULONG request, ULONG cbData,
                              PVOID pbData, ULONG priority);

• The argument priority is ignored.