Edit

SYNC

  • Article

Applies to: Outlook 2013 | Outlook 2016

Information for starting synchronization between a local store and a server. This information is used during the synchronize state.

Quick info

struct SYNC 
{ 
    ULONG ulFlags; 
    LPWSTR pwzPath; 
    FEID Reserved1; 
    MEID Reserved2; 
    LPENTRYLIST pel; 
    ULONG const * pulFolderOptions; 
};

Members

ulFlags

  • [out]/[in] A bitmask of the following flags that modifies the behavior during synchronization:

  • UPS_UPLOAD_ONLY

    • [in] The client will be performing only upload. Outlook only returns locally modified folders.

  • UPS_DNLOAD_ONLY

    • [in] The client will be performing only download. Outlook should not clear upload bits for folders.

  • UPS_THESE_FOLDERS

    • [in] The client will be synchronizing a specified set of folders with the provided entry IDs. This flag can be combined with either the UPS_UPLOAD_ONLY or UPS_DNLOAD_ONLY flag.

  • UPS_OK

    • [out] Synchronization was successful. The client sets this after uploading or a full synchronization completes.

      Note

      Even though the client can either upload or fully synchronize (upload then download) folders and items with the Replication API, the client specifies ulFlags with only one direction of the replication at a time — either the UPS_UPLOAD_ONLY or UPS_DNLOAD_ONLY flag. In the case of a full synchronization, the client first does an upload with the UPS_UPLOAD_ONLY flag, and then a download with the UPS_DNLOAD_ONLY flag.

pwzPath

  • [out] Path to the local store.

Reserved1

  • This member is reserved for the internal use of Outlook and is not supported.

Reserved2

  • This member is reserved for the internal use of Outlook and is not supported.

pel

  • [in] This is the list of entry IDs of the folders to synchronize if UPS_THESE_FOLDERS has been set. See mapidefs.h for the type definition of LPENTRYLIST.

pulFolderOptions

  • [in] This is an array of folder options for corresponding folders in pel if UPS_THESE_FOLDERS has been set. These folder options are used when uploading each of the folders listed in pel during the upload folder state. For more information about folder options, see UPFLD.

See also

About the Replication API
About the Replication State Machine
MAPI Constants