IProviderFilteredSyncServices::CreateFilterInfo
Создает объект ISyncFilterInfo, который может быть использован поставщиком источника для передачи данных о фильтре, который определяет, какие изменения будут включены в пакет изменений.
HRESULT CreateFilterInfo(
DWORD dwFlags,
ISyncFilterInfo ** ppFilterInfo);
Параметры
- dwFlags
[in] Флаги, которые задают дополнительные данные, касающиеся создаваемого объекта сведений о фильтре. Должен иметь значение SYNC_FILTER_INFO_FLAG_ITEM_LIST или SYNC_FILTER_INFO_FLAG_CHANGE_UNIT_LIST.
- ppFilterInfo
[out] Возвращает вновь созданный объект сведений о фильтре.
Возвращаемое значение
S_OK
E_INVALIDARG, если значение dwFlags не равно SYNC_FILTER_INFO_FLAG_ITEM_LIST или SYNC_FILTER_INFO_FLAG_CHANGE_UNIT_LIST.
E_OUTOFMEMORY
E_POINTER
SYNC_E_INVALID_OPERATION, если этот объект не был правильно инициализирован.
Замечания
Если в качестве значения параметра dwFlags указывается SYNC_FILTER_INFO_FLAG_ITEM_LIST, то Sync Framework возвращает объект, реализующий ISyncFilterInfo. В процессе реализации, выполняемой этим объектом, сериализуются сведения о версиях и флаги, указанные для dwFlags при вызове его метода ISyncFilterInfo::Serialize.
Если в качестве значения dwFlags указывается SYNC_FILTER_INFO_FLAG_CHANGE_UNIT_LIST, то платформа Sync Framework возвращает объект, реализующий интерфейс IChangeUnitListFilterInfo. Реализация, предоставляемая этим объектом, может использоваться для указания, что в пакет изменений в качестве элементов включается только определенный набор базовых единиц.