2.2.3.1.2.1.1 RopFastTransferDestinationConfigure ROP Request Buffer
The following descriptions define valid fields for the request buffer of the RopFastTransferDestinationConfigure ROP ([MS-OXCROPS] section 2.2.12.1).
InputServerObject: The value of this field MUST be either an Attachment object, Message object, or Folder object.
SourceOperation (1 byte): An 8-bit enumeration. This enumeration is used to specify the type of data in a FastTransfer stream that is uploaded by using the RopFastTransferDestinationPutBuffer ROP (section 2.2.3.1.2.2) on the FastTransfer upload context that is returned in the OutputServerObject field.
The following table defines the SourceOperation enumeration values and the associated root elements in the FastTransfer stream.
|
SourceOperation enumeration value |
Root element in FastTransfer stream |
Conditions |
|---|---|---|
|
CopyTo CopyProperties |
folderContent element |
The value of the InputServerObject field is a Folder object. |
|
messageContent element |
The value of the InputServerObject field is a Message object. |
|
|
attachmentContent element |
The value of the InputServerObject field is an Attachment object. |
|
|
CopyMessages |
messageList element |
Always. |
|
CopyFolder |
topFolder element |
Always. |
The following table defines the SourceOperation ordinal values.
|
SourceOperation enumeration value |
Ordinal value |
Corresponding ROP of the FastTransfer download* |
|---|---|---|
|
CopyTo |
0x01 |
RopFastTransferSourceCopyTo ROP (section 2.2.3.1.1.1) |
|
CopyProperties |
0x02 |
RopFastTransferSourceCopyProperties ROP (section 2.2.3.1.1.2) |
|
CopyMessages |
0x03 |
RopFastTransferSourceCopyMessages ROP (section 2.2.3.1.1.3) |
|
CopyFolder |
0x04 |
RopFastTransferSourceCopyFolder ROP (section 2.2.3.1.1.4) |
*If the FastTransfer stream to be uploaded was produced by a FastTransfer download operation, the value of the SourceOperation field MUST correspond to the RopFastTransferSourceCopy* ROP that was used to configure the download operation.
CopyFlags (1 byte): An 8-bit flag structure. This field defines the parameters of the FastTransfer upload 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 value of the InputServerObject field is a Folder object or 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. |