184.108.40.206 Downloading Messaging Objects Using FastTransfer
Clients can efficiently download copies of specified folders, messages or attachments using the binary format known as a FastTransfer stream. The following steps MUST be taken by a client to download copies of these messaging objects from the server using FastTransfer ROPs and FastTransfer streams:
Obtain a handle to a messaging object whose contents are requested, or obtain a handle to a messaging object that the client will download a copy of. To obtain the handle of a new messaging object, use the OutputHandleIndex field from the RopCreateMessage ROP ([MS-OXCROPS] section 220.127.116.11) response buffer. For more details about obtaining a handle to an existing messaging object, see [MS-OXCMSG] section 18.104.22.168.
Send the RopFastTransferSourceCopy* ROP request to create the FastTransfer download context on the server and define the parameters and the scope of the operation. The RopFastTransferSourceCopy* ROPs are specified in section 22.214.171.124.1.
Optionally, send a RopTellVersion ROP (section 126.96.36.199.1.6) request, if performing a server-to-client-to-server upload, as specified in section 188.8.131.52.1. Additional details about sending a RopTellVersion ROP request are specified in section 184.108.40.206.2.
Iteratively send RopFastTransferSourceGetBuffer ROP (section 220.127.116.11.1.5) requests on the FastTransfer context to retrieve the FastTransfer stream with serialized messaging objects. Additional details about sending a RopFastTransferSourceGetBuffer ROP request are specified in section 18.104.22.168.1.
Send a RopRelease ROP ([MS-OXCROPS] section 22.214.171.124) request to release the messaging object and FastTransfer context obtained in steps 1 and 2.