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