IOSTX::SyncBeg
适用于:Outlook 2013 | Outlook 2016
准备本地存储以在特定状态下进行同步,并检索复制所需的信息。
HRESULT SyncBeg(
UINT uiSync,
LPVOID *ppv
);
参数
uiSync
[in]本地存储将进入的状态。 下面是状态标识器的列表:
LR_SYNC_IDLE
LR_SYNC
LR_SYNC_UPLOAD_HIERARCHY
LR_SYNC_UPLOAD_FOLDER
LR_SYNC_CONTENTS
LR_SYNC_UPLOAD_TABLE
LR_SYNC_UPLOAD_MESSAGE
LR_SYNC_UPLOAD_MESSAGE_READ
LR_SYNC_UPLOAD_MESSAGE_DEL
LR_SYNC_DOWNLOAD_HIERARCHY
LR_SYNC_DOWNLOAD_TABLE
Ppv
[in]/[out] 指向对应于要输入的状态的数据结构的指针。
备注
客户端调用 IOSTX::SetSyncResult 来设置同步结果,然后调用 IOSTX::SyncEnd 以结束该状态。 客户端必须为每次调用 IOSTX::SyncBeg 调用 IOSTX::SyncEnd,以确定状态是否已成功复制。 确定这一点后,Outlook 可以开始清理其内部状态。
其中大多数结构包含 [out]/[in] 信息,使 Outlook 能够将信息传递给客户端,客户端可将信息传递给 Outlook。 当客户端调用 IOSTX::SyncBeg 时,Outlook 会为给定状态分配数据结构,并使用该状态的信息对其进行初始化。 这是 [out] 信息。 处于某个状态时,客户端会更新该状态的相应数据结构。 这是 [in] 信息。