Интерфейс 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