IOSTX [Outlook 2003 API Reference]
Provides synchronization methods. This interface retrieves the necessary information to replicate local changes to the server and server changes to the local store.
Quick Info
| Inherits from: | IUnknown |
| Provided by: | IPSTX::GetSyncObject |
| Interface identifier: | IID_IOSTX |
Vtable Order
| Placeholder member | Not supported or documented. |
| InitSync | Informs the local store that synchronization is about to start. |
| SyncBeg | Prepares the local store for synchronization in a particular state and retrieves the necessary information to replicate. |
| SyncEnd | Ends synchronization in the current state and exits that state. |
| SyncHdrBeg | Starts synchronization for a message header. |
| SyncHdrEnd | Ends synchronization for a message header. |
| SetSyncResult | Sets the result of the synchronization. |
| Placeholder member | Not supported or documented. |
Remarks
When a client uploads or synchronizes folders and folder contents on a local store, it moves the local store from one state to another as depicted in the state transition diagram in About the Replication State Machine. The following is the order of events for the client to move the local store from one state to another:
- The client calls IOSTX::InitSync to inform the local store that replication is about to start.
- Depending on the direction of replication and the objects to replicate, the client calls IOSTX::SyncBeg to begin replication in the appropriate state. Outlook provides the client the necessary information, and the client performs the replication.
- The client calls IOSTX::SetSyncResult to return the result of the replication.
- The client calls IOSTX::SyncEnd to end the replication, providing Outlook the necessary information for subsequent replication.
In particular, when downloading message items, the client uses IOSTX::SyncHdrBeg and IOSTX::SyncHdrEnd to update a full message item with the message header on the local store:
- Upon IOSTX::SyncHdrBeg, the local store transitions into the download message header state. Outlook initially provides the client with the current message header on the local store.
- The client downloads a full message item together with the message header.
- Outlook updates the item on the local store with the full message item.