Compartir a través de


IFilterTrackingSyncChangeBuilder::AddFilterChange

Agrega información que indica si este cambio hace que el elemento entre en un filtro especificado o salga de él.

HRESULT AddFilterChange(
  DWORD                      dwFilterKey, 
  const SYNC_FILTER_CHANGE * pFilterChange);

Parámetros

  • dwFilterIndex
    [in] Índice de un filtro en el mapa de claves de filtro de la réplica.
  • pFilterChange
    [in] Información sobre el cambio respecto al filtro especificado por dwFilterIndex.

Valor devuelto

  • S_OK

  • E_INVALIDARG si dwFilterIndex es un valor no válido.

  • E_OUTOFMEMORY

  • E_POINTER

  • SYNC_E_INVALID_OPERATION si ya existe información de cambio de filtro para dwFilterIndex.

Notas

Un cambio puede hacer que un elemento entre en un filtro o salga de él. Por ejemplo, los elementos contienen un campo state y un filtro excluye cualquier elemento cuyo campo state sea "Washington". Cuando un elemento con state igual a "Washington" cambia de forma que state es "Oregón", el elemento pasa al filtro.

Un proveedor que representa una réplica que realiza el seguimiento de los filtros debe llamar a este método para establecer información de seguimiento de filtros sobre cada cambio que se enumera.

Vea también

Referencia

Interfaz IFilterTrackingSyncChangeBuilder