IFilterTrackingSyncChangeBuilder::AddFilterChange
Adiciona informações que indicam se essa alteração faz o item ser movido para dentro ou para fora de um filtro especificado.
HRESULT AddFilterChange(
DWORD dwFilterKey,
const SYNC_FILTER_CHANGE * pFilterChange);
Parâmetros
- dwFilterIndex
[in] O índice de um filtro no mapa de chave de filtro da réplica.
- pFilterChange
[in] Informações sobre a alteração em relação ao filtro especificado por dwFilterIndex.
Valor de retorno
S_OK.
E_INVALIDARG quando dwFilterIndex for um valor inválido.
E_OUTOFMEMORY.
E_POINTER.
SYNC_E_INVALID_OPERATION quando informações de alteração de filtro já existirem para dwFilterIndex.
Comentários
Uma alteração pode fazer um item ser movido para dentro ou para fora de um filtro. Por exemplo, os itens contêm um campo state e um filtro exclui todos os itens cujo campo state seja igual a "Washington". Quando um item cujo campo state é igual a "Washington" é alterado de forma que state seja igual a "Oregon", o item é movido para dentro do filtro.
Um provedor que representa uma réplica que controla filtros deve chamar esse método para definir informações de controle de filtros sobre cada alteração enumerada.