2.4.29 FileMailslotSetInformation

This information class is used locally to set information on a mailslot.

A FILE_MAILSLOT_SET_INFORMATION data element, defined as follows, is provided by the caller.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

ReadTimeout

...

ReadTimeout (8 bytes):  A 64-bit signed integer that contains the time that a read operation can wait for a message to be written to the mailslot before a time-out occurs as follows:

  • A positive value specifies the operation time-out as an absolute system time on the server, represented as a count of 100-nanosecond intervals since January 1, 1601.

  • A negative value specifies the number of 100-nanosecond intervals for the operation to time out relative to the current server time.

  • A value of -1 (0xFFFFFFFFFFFFFFFF) requests that the read wait forever for a message without timing out.

  • A value of zero sends a request that the read not wait and return immediately, whether a pending message is available to be read or not.

This operation returns a status code as specified in section 2.2. Upon success, the status code returned by the function that processes this file information class is STATUS_SUCCESS. The most common error codes are listed in the following table.

Error code

Meaning

STATUS_INFO_LENGTH_MISMATCH

0xC0000004

The specified information record length does not match the length that is required for the specified information class.