Поделиться через


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», то элемент перемещается в фильтр.

Поставщик назначения, представляющий реплику, которая отслеживает фильтры, должен вызывать этот метод, чтобы получить обновленные данные о каждом изменении, которое применяется в реплике назначения.

См. также

Другие ресурсы

Интерфейс ISyncChangeWithFilterKeyMap