DosWriteMailslot or Dos32WriteMailslot

The DosWriteMailslot API writes a message to a particular mailslot.

To send a message to all computers on the primary domain that have a local mailslot with the same name, an application must pass the name parameter \\*\mailslot\name and the class parameter 2 to DosWriteMailslot.

Restrictions

Second-class messages must be 400 bytes or smaller when written to remote requesters; they can be any size when written to local computers or remote servers.

#include <netcons.h>
#include <mailslot.h>
 
DosWriteMailslot(pMailslotName, message, size,
               priority, class, timeout);      /* 16 bit */
 
Dos32WriteMailslot(pMailslotName, message, size,
               priority, class, timeout);      /* 32 bit */

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

pMailslotName

For the name of a local mailslot, use the format \mailslot\name.

For a remote mailslot, use \\computername\mailslot\ name.

For all mailslots with the same name, but on different computers in the primary domain, use \\*\mailslot\ name.

message

(const unsigned char LSFAR *) points to an ASCIIZ string containing the message to be written to the mailslot.

size

(16-bit unsigned short or 32-bit unsigned long) specifies the size (in bytes) of the message to be written.

priority

(16-bit unsigned short or 32-bit unsigned long) assigns a priority to the message. The priority of a message ranges from 0 (lowest) to 9 (highest). High-priority messages generally are placed ahead of previously stored messages with lower priority, except when the mailslot already is full.

class

First-class mail (class is 1) forces DosWriteMailslot to wait until a mailslot has enough room to accept message or until timeout is reached. First-class mail can be delivered only to remote servers or local computers.
Second-class mail (class is 2) causes DosWriteMailslot to fail if there is not enough room to write the message in the mailslot. Second-class mail can be delivered to requesters or servers.

timeout

(long) specifies the number of milliseconds to wait before discontinuing the attempt to write the message. A value of 0 means only one attempt is made. A value of -1 means DosWriteMailslot repeats the attempt until the message is written (or an error occurs).

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_PATH_NOT_FOUND Г 3 Г The path was not found. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_NOT_SUPPORTED Г 50 Г This request is not supported by Г
Г Г Г the network. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_INVALID_PARAMETER Г 87 Г At least one parameter value is Г
Г Г Г not valid. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_INTERRUPT Г 95 Г A system call has been inter- Г
Г Г Г rupted. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_BROKEN_PIPE Г 109 Г Write on pipe that is not being Г
Г Г Г read. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_BUFFER_OVERFLOW Г 111 Г The buffer passed to the system Г
Г Г Г call is too small to hold return Г
Г Г Г data. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_SEM_TIMEOUT Г 121 Г A timeout happened from the Г
Г Г Г semaphore API functions. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_NetNotStarted Г 2102 Г The redirector NETWKSTA.200 has Г
Г Г Г not been started. Г
РФФФФФФФФФФФФФФФФФФФФФФФФФФФФФСФФФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

Other codes could be returned from the following functions:

DosAllocSeg
DosDevIOCtl
DosFsCtl
DosGetShrSeg
DosSemRequest

For information about:

Creating a mailslot, see Mailslot - DosMakeMailslot.
[Back] [Next]