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] 指向对应于要输入的状态的数据结构的指针。

DNHIER

DNTBL

DNTBL

同步

SYNCCONT

UPDEL

UPDELE

UPFLD

UPHIER

UPMOV

UPMSG

UPREAD

UPREADE

UPTBL

UPTBLE

备注

客户端调用 IOSTX::SetSyncResult 来设置同步结果,然后调用 IOSTX::SyncEnd 以结束该状态。 客户端必须为每次调用 IOSTX::SyncBeg 调用 IOSTX::SyncEnd,以确定状态是否已成功复制。 确定这一点后,Outlook 可以开始清理其内部状态。

其中大多数结构包含 [out]/[in] 信息,使 Outlook 能够将信息传递给客户端,客户端可将信息传递给 Outlook。 当客户端调用 IOSTX::SyncBeg 时,Outlook 会为给定状态分配数据结构,并使用该状态的信息对其进行初始化。 这是 [out] 信息。 处于某个状态时,客户端会更新该状态的相应数据结构。 这是 [in] 信息。

另请参阅

IOSTX::GetLastError

IOSTX::InitSync

IOSTX::SetSyncResult

IOSTX::SyncEnd

IOSTX::SyncHdrBeg

IOSTX::SyncHdrEnd

IOSTX : IUnknown

MAPI 常量