Compartilhar via


IProviderFilteredSyncServices::CreateFilterInfo

Cria um objeto ISyncFilterInfo que um provedor de origem pode usar para transmitir informações sobre o filtro usado para controlar quais alterações são incluídas em um lote de alterações.

HRESULT CreateFilterInfo(
  DWORD dwFlags,
  ISyncFilterInfo ** ppFilterInfo);

Parâmetros

  • dwFlags
    [in] Os sinalizadores que especificam informações adicionais sobre o objeto de filtro a ser criado. Deve ser SYNC_FILTER_INFO_FLAG_ITEM_LIST ou SYNC_FILTER_INFO_FLAG_CHANGE_UNIT_LIST.
  • ppFilterInfo
    [out] Retorna o objeto de informações de filtro recém-criado.

Valor de retorno

  • S_OK

  • E_INVALIDARG quando dwFlags não for SYNC_FILTER_INFO_FLAG_ITEM_LIST nem SYNC_FILTER_INFO_FLAG_CHANGE_UNIT_LIST.

  • E_OUTOFMEMORY

  • E_POINTER

  • SYNC_E_INVALID_OPERATION se esse objeto não tiver sido inicializado corretamente.

Comentários

Quando SYNC_FILTER_INFO_FLAG_ITEM_LIST é especificado para o valor dwFlags, Sync Framework retorna um objeto que implementa ISyncFilterInfo. A implementação fornecida por esse objeto serializa informações de versão e os sinalizadores que são especificados para dwFlags quando seu método ISyncFilterInfo::Serialize é chamado.

Quando SYNC_FILTER_INFO_FLAG_CHANGE_UNIT_LIST é especificado para o valor dwFlags, Sync Framework retorna um objeto que implementa IChangeUnitListFilterInfo. A implementação fornecida por esse objeto pode ser usada para especificar que só um determinado conjunto de unidades de alteração é incluído para itens em um lote de alterações.

Consulte também

Referência

Interface IProviderFilteredSyncServices