2.2.3.1.1.3.1 RopFastTransferSourceCopyMessages ROP Request Buffer

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

InputServerObject: The value of this field MUST be a Folder object.

MessageIdCount (2 bytes): An unsigned 16-bit integer. This value specifies the number of identifiers in the MessageIds field. The value of this field MUST be greater than zero.

MessageIds (variable): An array of 64-bit identifiers. This list specifies the MID structures ([MS-OXCDATA] section 2.2.1.2) of the messages to be copied. Messages MUST be contained by a folder identified by the InputServerObject field.

CopyFlags (1 byte): An 8-bit flag structure. This field defines the parameters of the FastTransfer download operation.

The following table defines valid bit flags for the CopyFlags field.

Flag name

Value

Description

Move

0x01

This bit flag MUST only be set if the value of the InputServerObject field is a Folder object.

If this bit flag is set, the FastTransfer operation is being configured as a logical part of a larger object move operation, as opposed to a copy operation, and the client will issue further operations such as deleting the moved messages from the source.

If this bit flag is not set, the FastTransfer operation is not being configured as a logical part of a larger object move operation. For more details, see section 3.2.5.8.1.3.

Unused1

0x02

This bit flag MUST be ignored on receipt.

Unused2

0x04

This bit flag MUST be ignored on receipt.

Unused3

0x08

The client MUST NOT set this flag.

BestBody

0x10

This bit flag MAY<5> identify whether the output message body is in the original format or compressed RTF format. For more details, see section 3.2.5.8.1.3.

SendEntryId

0x20

This bit flag indicates whether message change information is included in the FastTransfer stream.

If this bit flag is set, the PidTagSourceKey (section 2.2.1.2.5), PidTagChangeKey (section 2.2.1.2.7), PidTagLastModificationTime ([MS-OXCMSG] section 2.2.2.2) and PidTagPredecessorChangeList (section 2.2.1.2.8) properties are included in the FastTransfer stream. In addition, the value of the PidTagEntryId property ([MS-OXCPERM] section 2.2.4) is assigned to the PidTagOriginalEntryId property (section 2.2.1.2.9).

If this bit flag is not set, the PidTagSourceKey, PidTagChangeKey, PidTagLastModificationTime, PidTagPredecessorChangeList, and PidTagOriginalEntryId properties are not included in the FastTransfer stream.

For more details, see section 3.2.5.8.1.3.

SendOptions (1 byte): An 8-bit flag structure. The possible values for this structure are defined in section 2.2.3.1.1.1.1.

Show: