关于复制 API

适用于:Outlook 2013 | Outlook 2016

复制 API 提供 MAPI 消息存储提供程序的功能,用于在服务器与为该提供程序创建的基于 .pst 的专用本地存储之间同步Microsoft Outlook 2013项或Microsoft Outlook 2010项。

注意

MAPI 消息存储提供程序必须按照 关于复制状态机中的说明实现复制 API。 提供程序必须仅在为自身创建的个人存储上使用 API,而不能在为其他提供程序创建的个人存储上使用 API,因为为其他提供程序创建的个人存储可能已使用各自的服务器设置了自己的复制机制。 例如,脱机文件夹文件 (.ost) 与 Microsoft Exchange 服务器保持自己的复制关系。

若要使用复制 API,MAPI 消息存储提供程序必须首先通过调用 NSTServiceEntry 打开并包装基于 .pst 的本地存储。 然后,提供程序可以使用 API、 IOSTXIPSTX 的主要接口来执行复制。 IPSTX 通过在 IMsgStore 上查询来提供:IMAPIProp,IOSTXIPSTX::GetSyncObject 提供。

IOSTX 接口

IOSTX 接口是在复制 API 中执行同步的主接口。 IOSTX 通过一系列状态移动本地存储,检索每个状态中有关本地存储中更改的信息,并通知本地存储服务器上的更改。 复制 API 还指定了许多支持同步的数据结构。

存储提供程序(作为此 API 的客户端)使用复制 API 包装本地存储并浏览这些状态,在本地存储中推送更改 (例如文件夹层次结构的更改或向服务器添加新项) ,以及检索有关服务器上更改的信息,并将该信息提供给 IOSTX 接口。 IOSTX 接口采用由 Microsoft Exchange Server 提供的增量更改同步 (ICS) 。 有关 ICS 的详细信息,请参阅 ICS 评估条件。 通过 IOSTX,客户端使用 ICS 监视和同步对本地存储中层次结构或内容的增量更改。

IPSTX 接口

从 IPSTX 继承的 IPSTX 和其他五个 IPSTX n 接口提供了帮助器功能,可在通过 IOSTX 接口执行复制时使用。 例如, IPSTX::EmulateSpooler 允许使本地存储模拟 Outlook 协议管理器,以便将传出邮件假脱机到服务器。

有关复制期间的状态转换的详细信息,请参阅 关于复制状态机

复制 API

复制 API 提供以下定义、数据类型和接口。 有关包装的个人文件夹文件 (PST) 存储提供程序的示例实现,请参阅 关于示例包装 PST 存储提供程序

定义:

函数:

数据类型:

接口: