ISyncMgrEventStore-Schnittstelle (syncmgr.h)

Macht Methoden verfügbar, die es einem Handler ermöglichen, einen eigenen Ereignisspeicher bereitzustellen und seine eigenen Synchronisierungsereignisse zu verwalten, anstatt den standardmäßigen Sync Center-Ereignisspeicher zu verwenden. Diese Ereignisse werden im Ordner Synchronisierungsergebnisse angezeigt.

Vererbung

Die ISyncMgrEventStore-Schnittstelle erbt von der IUnknown-Schnittstelle . ISyncMgrEventStore verfügt auch über folgende Membertypen:

Methoden

Die ISyncMgrEventStore-Schnittstelle verfügt über diese Methoden.

ISyncMgrEventStore::GetEvent Ruft ein angegebenes Ereignisobjekt ab.
ISyncMgrEventStore::GetEventCount Ruft die Ereignisanzahl ab.
ISyncMgrEventStore::GetEventEnumerator Ruft einen Enumerator für die Ereignisse eines Handlers ab.
ISyncMgrEventStore::RemoveEvent Entfernt Ereignisse wie angegeben.

Hinweise

Wann sollte implementiert werden?

Das Synchronisierungscenter stellt einen Standardereignisspeicher bereit, mit dem Handler Ereignisse melden können, die dann im Ordner Synchronisierungsergebnisse angezeigt werden. Wenn eine Komponente bereits Ereignisse protokolliert, ist es möglicherweise bequemer, einen eigenen Ereignisspeicher bereitzustellen, der Ereignisse für diesen Handler aufzählt. In diesem Fall würde der Ereignisspeicher das von der Komponente protokollierte Ereignis einfach in ein Formular übersetzen, das vom Synchronisierungscenter verwendet werden kann.

Sync Center fordert einen Ereignisspeicher von einem Handler an, indem zuerst die von ISyncMgrHandler::GetCapabilities zurückgegebene Maske für das SYNCMGR_HCM_EVENT_STORE-Flag untersucht wird. Wenn dieser Wert vorhanden ist, ruft das Synchronisierungscenter ISyncMgrHandler::GetObject mit dem SYNCMGR_OBJECTID_EventStore-Wert auf. Der Handler kann auch einen nach Element gefilterten Ereignisspeicher bereitstellen, indem das SYNCMGR_ICM_EVENT_STORE-Flag in der von ISyncMgrSyncItem::GetCapabilities zurückgegebenen Maske festgelegt wird.

Wenn dem Ereignisspeicher Ereignisse hinzugefügt werden, sollte der Handler (oder eine zugehörige Komponente) ISyncMgrControl::UpdateEvents aufrufen, damit der Ordner Synchronisierungsergebnisse und die Fehleranzahl aktualisiert werden können.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	syncmgr.h