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