The DosReadMailslot API reads and then removes the next available message of a mailslot.

Messages are stored in a mailslot based on their priority (0-9). An incoming message with a higher priority might be stored ahead of a previously stored message with the same or lower priority.

Restrictions

This API can be called from DLS and OS/2 workstations. A call to this API must be issued locally.
Syntax

#include <netcons.h>
#include <mailslot.h>
 
DosReadMailslot(mailslothandle, buf, pusBytesReturned,
         nextsize, nextpriority, timeout);     /* 16 bit */
 
Dos32ReadMailslot(mailslothandle, buf, pulBytesReturned,
         nextsize, nextpriority, timeout);     /* 32 bit */

Parameters

See Common Parameter Definitions for descriptions of parameters not defined here.

mailslothandle

(unsigned long) specifies (by its handle) the mailslot to read.
nextsize
(16-bit unsigned short LSFAR * or 32-bit unsigned long LSFAR *) points to an unsigned short integer indicating the size (in bytes) of the next message in the mailslot. If 0, no message is available.
nextpriority
(16-bit unsigned short LSFAR * or 32-bit unsigned long LSFAR *) points to an unsigned short integer indicating the priority (0 through 9) of the next message in the mailslot. (This parameter is undefined if nextsize is 0.)
timeout
(long) specifies the number of milliseconds to wait if a message is not available immediately. If 0, DosReadMailslot does not wait; if -1, DosReadMailslot waits indefinitely.
Return Codes

The following table lists the return codes most significant to this API. (See API Return Codes for a complete list of return codes.) ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿³SYMBOLICCONSTANT ³VALUE³MEANING ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ NERR_Success ³ 0 ³ No errors were encountered. ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ ERROR_INVALID_HANDL³ 6 ³ The specified handle is not valid. ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ ERROR_INTERRUPT ³ 95 ³ A system call has been interrupted. ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ ERROR_BROKEN_PIPE ³ 109 ³ Write on pipe that is not being read. ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ ERROR_SEM_TIMEOUT ³ 121 ³ A timeout happened from the semaphore API func- ³
³ ³ ³ tions. ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ


Other codes could be returned by the DosSemRequest function.

Related Information

For information about:

• Reading a message without removing it, see Mailslot - DosPeekMailslot.
  
• Writing a message to a mailslot, see Mailslot - DosWriteMailslot.

---

[Back] [Next]