dos12.hlp (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
DosQueryQueue (1.2)
Function Group  Overview                          Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_DOSQUEUES
 
USHORT DosQueryQueue(hqueue, pusElemCount)
HQUEUE hqueue;           /* queue handle                          */
PUSHORT pusElemCount;    /* pointer to variable for element count */
 
The DosQueryQueue function retrieves a count of the number of elements in
the given queue. Any process that has a queue open can call this function.
 
Parameter     Description
────────────────────────────────────────────────────────────────────────────
 
hqueue        Identifies the queue about which information is sought. This
              handle must have been previously created or opened by using
              the DosCreateQueue or DosOpenQueue function.
 
pusElemCount  Points to the variable that receives the count of elements in
              the queue.
 
Return Value
 
The return value is zero if the function is successful. Otherwise, it is an
error value, which may be the following:
 
     ERROR_QUE_INVALID_HANDLE
 
See Also
 
DosCreateQueue, DosOpenQueue