IFilterTrackingSaveChangeContext::GetFilterChange
Obtém informações que indicam se essa alteração faz o item ser movido para dentro ou para fora de um 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.
- pFilterChange
[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 controlar o filtro especificado.
E_INVALIDARG quando dwFilterIndex for um valor inválido.
E_POINTER.
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 controla filtros deve chamar esse método para recuperar informações atualizadas sobre cada alteração aplicada à réplica de destino.