Share via

2.2.3.1.1.2.1 RopFastTransferSourceCopyProperties ROP Request Buffer

  • Article

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

InputServerObject: This value of this field MUST be either an Attachment object, Message object, or Folder object.

Level (1 byte): An unsigned 8-bit integer. This value MUST be set to 0x00 to copy descendant subobjects by using the property list specified by the PropertyTags field. This value MUST be set to a nonzero value to exclude all descendant subobjects from being copied. A nonzero value can only be passed when the value of the InputServerObject field is a Message object or Folder object. The value of the Level field MUST be ignored and treated as if it is set to 0x00 if the value of the InputServerObject field is an Attachment object.

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

The following table defines valid flags for the CopyFlags field.

Flag name

Value

Description

Move

0x01

This flag MUST only be set if the InputServerObject field is a Folder object or a Message object.

If this 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 flag is not set, the FastTransfer operation is not being configured as a logical part of a larger object move operation.

Unused1

0x02

This flag MUST be ignored on receipt.

Unused2

0x04

This flag MUST be ignored on receipt.

Unused3

0x08

This flag MUST be ignored on receipt.

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.

PropertyTagCount (2 bytes): An unsigned 16-bit integer. This value specifies the number of structures in the PropertyTags field. This value MUST NOT be set to 0x0000.

PropertyTags (variable): An array of PropertyTag structures ([MS-OXCDATA] section 2.9). This array specifies the properties and subobjects, as specified in section 2.2.1.7, to copy from the messaging object pointed to by the InputServerObject field. Note that this field MUST NOT be considered when determining what properties and subobjects to copy for descendant subobjects of the InputServerObject field. For more details about the effect of property and subobject filters on download operations, see section 3.2.5.10.