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.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
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. |