Interface ISyncMgrEventStore (syncmgr.h)

Expose des méthodes qui permettent à un gestionnaire de fournir son propre magasin d’événements et de gérer ses propres événements de synchronisation, au lieu d’utiliser le magasin d’événements du Centre de synchronisation par défaut. Ces événements sont affichés dans le dossier Résultats de la synchronisation.

Héritage

L’interface ISyncMgrEventStore hérite de l’interface IUnknown. ISyncMgrEventStore a également les types de membres suivants :

Méthodes

L’interface ISyncMgrEventStore utilise ces méthodes.

ISyncMgrEventStore ::GetEvent Obtient un objet d’événement spécifié.
ISyncMgrEventStore ::GetEventCount Obtient le nombre d’événements.
ISyncMgrEventStore ::GetEventEnumerator Obtient un énumérateur pour les événements d’un gestionnaire.
ISyncMgrEventStore ::RemoveEvent Supprime les événements, comme spécifié.

Remarques

Quand implémenter

Le Centre de synchronisation fournit un magasin d’événements par défaut que les gestionnaires peuvent utiliser pour signaler des événements, qui sont ensuite affichés dans le dossier Résultats de la synchronisation. Si un composant enregistre déjà des événements, il peut être plus pratique pour lui de fournir son propre magasin d’événements qui énumère les événements pour ce gestionnaire. Dans ce cas, le magasin d’événements traduit simplement l’événement comme journalisé par le composant dans un formulaire qui peut être utilisé par le Centre de synchronisation.

Le Centre de synchronisation demande un magasin d’événements à partir d’un gestionnaire en examinant d’abord le masque retourné par ISyncMgrHandler ::GetCapabilities pour l’indicateur SYNCMGR_HCM_EVENT_STORE. Si cette valeur est présente, le Centre de synchronisation appelle ISyncMgrHandler ::GetObject avec la valeur SYNCMGR_OBJECTID_EventStore. Le gestionnaire peut également fournir un magasin d’événements filtré par élément en définissant l’indicateur SYNCMGR_ICM_EVENT_STORE dans le masque retourné par ISyncMgrSyncItem ::GetCapabilities.

Si des événements sont ajoutés au magasin d’événements, le gestionnaire (ou un composant associé) doit appeler ISyncMgrControl ::UpdateEvents afin que le dossier Résultats de synchronisation et le nombre d’erreurs puissent être mis à jour.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	syncmgr.h