IFilterRequestCallback::RequestFilter

  • Artículo

Solicita que el filtro que proporcionó el proveedor de destino lo utilice el proveedor de origen durante la enumeración de cambios.

HRESULT RequestFilter(
  IUnknown * pFilter,
  FILTERING_TYPE filteringType);

Parámetros

Término

Definición

pFilter

[in] Filtro especificado por el proveedor de destino. Este filtro se pasa al proveedor de origen que se va a utilizar durante la enumeración de cambios.

filteringType

[in] Indica el tipo de información incluida en un lote de cambios durante la sincronización filtrada.

Valor devuelto

  • S_OK

  • E_POINTER

  • SYNC_E_FILTER_NOT_SUPPORTED, si el proveedor de origen no admite el filtro que especifica pFilter. También se devuelve si el proveedor de origen no implementa ISupportFilteredSync.

Notas

La negociación de filtros se logra a través de los pasos siguientes:

  1. Antes de que el proveedor comience a enumerar los cambios, Sync Framework inicia la negociación de filtros llamando a IRequestFilteredSync::SpecifyFilter en el proveedor de destino.

  2. Durante el procesamiento de IRequestFilteredSync::SpecifyFilter, el proveedor de destino pasa filtros a IFilterRequestCallback::RequestFilter.

  3. Durante el procesamiento de IFilterRequestCallback::RequestFilter, Sync Framework llama a ISupportFilteredSync::AddFilter en el proveedor de origen. Si el proveedor de origen no admite el filtro solicitado, el proveedor de destino puede continuar solicitando filtros hasta encontrar uno admitido.

Cuando se ha negociado un filtro correctamente, el proveedor de origen lo utiliza para determinar qué elementos incluir durante la enumeración de cambios.

Vea también

Referencia

Interfaz IFilterRequestCallback
Interfaz IRequestFilteredSync
Interfaz ISupportFilteredSync