ISyncChangeWithFilterKeyMap::GetFilterChange
Возвращает значение, показывающее, имеется ли этот элемент в указанном фильтре.
HRESULT GetFilterChange(
DWORD dwFilterKey,
SYNC_FILTER_CHANGE * pFilterChange);
Параметры
- dwFilterKey
[in] Ключ, определяющий фильтр в схеме ключей фильтра для реплики назначения.
- pfHasBeenInTheFilter
[out] Возвращает сведения, показывающие, вызывает это изменение перемещение элемента в фильтр или из фильтра, определяемого параметром dwFilterKey.
Возвращаемое значение
S_OK.
S_FALSE, если поставщик источника не отслеживает указанный фильтр.
E_INVALIDARG, если dwFilterIndex является недопустимым значением.
E_POINTER.
SYNC_E_SOURCE_DOES_NOT_TRACK_FILTER, если указанный фильтр не отслеживается.
Замечания
Изменение может вызвать перемещение элемента в фильтр или из фильтра. Например, элементы содержат поле state, а фильтр исключает все элементы, в которых поле state имеет значение «Washington». Если элемент, в котором поле state имеет значение «Washington», изменяется таким образом, что поле state получает значение «Oregon», то элемент перемещается в фильтр.
Поставщик назначения, представляющий реплику, которая отслеживает фильтры, должен вызывать этот метод, чтобы получить обновленные данные о каждом изменении, которое применяется в реплике назначения.