Интерфейс ISyncMgrEventStore (syncmgr.h)

Предоставляет методы, позволяющие обработчику предоставлять собственное хранилище событий и управлять собственными событиями синхронизации вместо использования хранилища событий центра синхронизации по умолчанию. Эти события отображаются в папке Результаты синхронизации.

Наследование

Интерфейс ISyncMgrEventStore наследуется от интерфейса IUnknown . ISyncMgrEventStore также имеет следующие типы элементов:

Методы

Интерфейс ISyncMgrEventStore содержит следующие методы.

ISyncMgrEventStore::GetEvent Возвращает указанный объект события.
ISyncMgrEventStore::GetEventCount Возвращает число событий.
ISyncMgrEventStore::GetEventEnumerator Возвращает перечислитель для событий обработчика.
ISyncMgrEventStore::RemoveEvent Удаляет события, как указано.

Комментарии

Когда следует реализовать

Центр синхронизации предоставляет хранилище событий по умолчанию, с помощью которого обработчики могут сообщать о событиях, которые затем отображаются в папке "Результаты синхронизации". Если компонент уже регистрирует события, ему может быть удобнее предоставить собственное хранилище событий, которое перечисляет события для этого обработчика. В этом случае хранилище событий просто преобразовывает событие как зарегистрированное компонентом в форму, которую может использовать центр синхронизации.

Центр синхронизации запрашивает хранилище событий из обработчика, сначала проверяя маску, возвращенную ISyncMgrHandler::GetCapabilities , на наличие флага SYNCMGR_HCM_EVENT_STORE. Если это значение присутствует, центр синхронизации вызывает ISyncMgrHandler::GetObject со значением SYNCMGR_OBJECTID_EventStore. Обработчик также может предоставить хранилище событий, отфильтрованное по элементу, установив флаг SYNCMGR_ICM_EVENT_STORE в маске, возвращаемой из ISyncMgrSyncItem::GetCapabilities.

Если события добавляются в хранилище событий, обработчик (или связанный компонент) должен вызвать ISyncMgrControl::UpdateEvents , чтобы можно было обновить папку "Результаты синхронизации" и счетчики ошибок.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	syncmgr.h