ISyncChangeWithFilterKeyMap::GetFilterChange
Obtém um valor que indica se esse item está no filtro especificado.
HRESULT GetFilterChange(
DWORD dwFilterKey,
SYNC_FILTER_CHANGE * pFilterChange);
Parâmetros
- dwFilterKey
[in] A chave que identifica o filtro no mapa de chave de filtro da réplica de destino.
- pfHasBeenInTheFilter
[out] Retorna informações que indicam se essa alteração faz o item ser movido para dentro ou para fora do filtro identificado por dwFilterKey.
Valor de retorno
S_OK.
S_FALSE quando o provedor de origem não rastrear o filtro especificado.
E_INVALIDARG quando dwFilterIndex for um valor inválido.
E_POINTER.
SYNC_E_SOURCE_DOES_NOT_TRACK_FILTER quando o filtro especificado não for rastreado.
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 de destino que representa uma réplica que rastreia filtros deve chamar esse método para recuperar informações atualizadas sobre cada alteração aplicada à réplica de destino.