2.2.3.10.1 RopSetReadFlags ROP Request Buffer

The following descriptions define valid fields for the request buffer of the RopSetReadFlags ROP ([MS-OXCROPS] section 2.2.6.10).

WantAsynchronous: 1 byte indicating whether client is prepared for the RopSetReadFlags ROP request to be processed asynchronously with status reported via the RopProgress ROP ([MS-OXCROPS] section 2.2.8.13).

ReadFlags: 1 byte containing a bitwise OR of zero or more values from the following table. The server modifies bits on the PidTagMessageFlags property (section 2.2.1.6). The flags, rfGenerateReceiptOnly, rfsuppressReceipt, and rfClearReadFlag, (rfClearNotifyRead or rfClearNotifyUnread), are mutually exclusive.

Flag name

Value

Description

rfDefault

0x00

The server sets the read flag and sends the receipt.

rfSuppressReceipt

0x01

The user requests that any pending read receipt be canceled; the server sets the mfRead bit.

rfReserved

0x0A

Ignored by the server.

rfClearReadFlag

0x04

Server clears the mfRead bit; the client MUST include the rfSuppressReceipt bit with this flag.

rfGenerateReceiptOnly

0x10

The server sends a read receipt if one is pending, but does not change the mfRead bit.

rfClearNotifyRead

0x20

The server clears the mfNotifyRead bit but does not send a read receipt.

rfClearNotifyUnread

0x40

The server clears the mfNotifyUnread bit but does not send a nonread receipt.

MessageIdCount: 2 bytes containing the number of elements in the MessageIds field.

MessageIds: An array of MIDs ([MS-OXCDATA] section 2.2.1.2) whose length is equal to the value of the MessageIdCount field.