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.