Informationen über die Replikations-API
Gilt für: Outlook 2013 | Outlook 2016
Die Replikations-API stellt die Funktionalität für einen MAPI-Nachrichtenspeicheranbieter bereit, um Microsoft Outlook 2013 oder Microsoft Outlook 2010 Elemente zwischen einem Server und einem privaten pst-basierten lokalen Speicher zu synchronisieren, der für diesen Anbieter erstellt wird.
Hinweis
Ein MAPI-Nachrichtenspeicheranbieter muss die Replikations-API gemäß den Anweisungen unter Informationen zum Replikationsstatuscomputer implementieren. Der Anbieter darf die API nur für einen persönlichen Speicher verwenden, der für sich selbst erstellt wurde, und nicht für persönliche Speicher, die für andere Anbieter erstellt wurden, da persönliche Speicher, die für andere Anbieter erstellt wurden, möglicherweise bereits eigene Replikationsmechanismen mit dem jeweiligen Server eingerichtet haben. Beispielsweise unterhält eine Offlineordnerdatei (OST) eine eigene Replikationsbeziehung mit einem Microsoft Exchange-Server.
Um die Replikations-API verwenden zu können, muss ein MAPI-Nachrichtenspeicheranbieter zuerst einen PST-basierten lokalen Speicher durch Aufrufen von NSTServiceEntry öffnen und umschließen. Der Anbieter kann dann die Hauptschnittstellen der API, IOSTX und IPSTX, verwenden, um die Replikation durchzuführen. IPSTX wird durch Abfragen in IMsgStore bereitgestellt: IMAPIProp, und IOSTX wird von IPSTX::GetSyncObject bereitgestellt.
Die IOSTX-Schnittstelle
Die IOSTX-Schnittstelle ist die primäre Schnittstelle, die die Synchronisierung in der Replikations-API ausführt. IOSTX verschiebt den lokalen Speicher durch eine Reihe von Zuständen, ruft Informationen in jedem Zustand zu Änderungen im lokalen Speicher ab und informiert den lokalen Speicher über Änderungen auf dem Server. Die Replikations-API gibt auch viele Datenstrukturen an, die die Synchronisierung unterstützen.
Ein Speicheranbieter als Client für diese API verwendet die Replikations-API, um den lokalen Speicher zu umschließen und sich durch diese Zustände zu bewegen, Änderungen im lokalen Speicher (z. B. Änderungen an der Ordnerhierarchie oder das Hinzufügen neuer Elemente) an den Server zu pushen und außerdem Informationen zu Änderungen auf dem Server abzurufen und diese Informationen an die IOSTX-Schnittstelle bereitzustellen. Die IOSTX-Schnittstelle verwendet die von Microsoft Exchange Server bereitgestellte inkrementelle Änderungssynchronisierung (ICS). Weitere Informationen zu ICS finden Sie unter ICS-Bewertungskriterien. Über IOSTX verwendet der Client ICS, um inkrementelle Änderungen an der Hierarchie oder dem Inhalt in einem lokalen Speicher zu überwachen und zu synchronisieren.
Die IPSTX-Schnittstelle
IPSTX und fünf weitere IPSTX n-Schnittstellen , die von IPSTX erben, bieten Hilfsfunktionen, die bei der Replikation über die IOSTX-Schnittstelle verwendet werden können. Mit IPSTX::EmulateSpooler können Sie beispielsweise festlegen, dass der lokale Speicher den Outlook-Protokoll-Manager emulieren kann, um ausgehende Nachrichten an einen Server zu spoolen.
Weitere Informationen zu Zustandsübergängen während der Replikation finden Sie unter Informationen zum Replikationsstatuscomputer.
Die Replikations-API
Die Replikations-API stellt die folgenden Definitionen, Datentypen und Schnittstellen bereit. Eine Beispielimplementierung eines Speicheranbieters für umschlossene Persönliche Ordner-Dateien (PST) finden Sie unter Informationen zum Beispiel für umschlossenen PST-Speicheranbieter.
Definitionen:
Funktionen:
Datentypen:
Schnittstellen: