À propos de l’API de réplication
S’applique à : Outlook 2013 | Outlook 2016
L’API de réplication fournit la fonctionnalité permettant à un fournisseur de magasin de messages MAPI de synchroniser Microsoft Outlook 2013 ou Microsoft Outlook 2010 éléments entre un serveur et un magasin local .pst privé créé pour ce fournisseur.
Remarque
Un fournisseur de magasin de messages MAPI doit implémenter l’API de réplication conformément aux instructions fournies dans À propos de l’ordinateur d’état de réplication. Le fournisseur doit utiliser l’API uniquement sur un magasin personnel créé pour lui-même, et non sur des magasins personnels créés pour d’autres fournisseurs, car les magasins personnels créés pour d’autres fournisseurs ont peut-être déjà configuré leurs propres mécanismes de réplication avec le serveur respectif. Par exemple, un fichier de dossier hors connexion (.ost) conserve sa propre relation de réplication avec un serveur Microsoft Exchange.
Pour utiliser l’API de réplication, un fournisseur de magasin de messages MAPI doit d’abord ouvrir et encapsuler un magasin local basé sur .pst en appelant NSTServiceEntry. Le fournisseur peut ensuite utiliser les principales interfaces de l’API, IOSTX et IPSTX, pour effectuer la réplication. IPSTX est fourni en interrogeant sur IMsgStore : IMAPIProp, et IOSTX est fourni par IPSTX ::GetSyncObject.
The IOSTX Interface
L’interface IOSTX est l’interface principale qui effectue la synchronisation dans l’API de réplication. IOSTX déplace le magasin local dans une série d’états, en récupérant des informations dans chaque état sur les modifications apportées au magasin local et en informant le magasin local des modifications sur le serveur. L’API de réplication spécifie également de nombreuses structures de données qui prennent en charge la synchronisation.
Un fournisseur de magasins, en tant que client de cette API, utilise l’API de réplication pour encapsuler le magasin local et parcourir ces états, en transmettant les modifications sur le magasin local (telles que les modifications apportées à la hiérarchie de dossiers ou l’ajout de nouveaux éléments) au serveur, ainsi qu’en récupérant des informations sur les modifications sur le serveur et en fournissant ces informations à l’interface IOSTX . L’interface IOSTX adopte la synchronisation des modifications incrémentielles (ICS) fournie par Microsoft Exchange Server. Pour plus d’informations sur ICS, consultez Critères d’évaluation ICS. Par le biais d’IOSTX, le client utilise ICS pour surveiller et synchroniser les modifications incrémentielles apportées à la hiérarchie ou au contenu d’un magasin local.
The IPSTX Interface
IPSTX et cinq autres interfaces IPSTX n qui héritent d’IPSTX fournissent des fonctionnalités d’assistance qui peuvent être utilisées lors de l’exécution de la réplication via l’interface IOSTX . Par exemple, IPSTX ::EmulateSpooler vous permet de faire en sorte que le magasin local émule le Gestionnaire de protocoles Outlook pour mettre en pool les messages sortants vers un serveur.
Pour plus d’informations sur les transitions d’état pendant la réplication, consultez À propos de l’ordinateur d’état de réplication.
API de réplication
L’API de réplication fournit les définitions, types de données et interfaces suivants. Pour obtenir un exemple d’implémentation d’un fournisseur de magasins pour les fichiers de dossiers personnels encapsulés (PST), consultez À propos de l’exemple de fournisseur de magasin PST encapsulé.
Définitions :
Fonctions :
Types de données :
Interfaces :