IFilterTrackingSaveChangeContext::GetFilterChange

获取指示此变更是否会导致项移入或移出指定筛选器的信息。

HRESULT GetFilterChange(
  DWORD                dwFilterKey,
  SYNC_FILTER_CHANGE * pFilterChange);

参数

  • dwFilterKey
    [in] 标识目标副本的筛选键映射中的筛选器的键。
  • pFilterChange
    [out] 返回指示此变更会导致项移入或移出 dwFilterKey 指定的筛选器的信息。

返回值

  • S_OK。

  • 如果源提供程序不跟踪指定的筛选器,则返回值为 S_FALSE。

  • 如果 dwFilterIndex 是一个无效值,则返回值为 E_INVALIDARG。

  • E_POINTER。

备注

变更可导致项移入或移出筛选器。例如,项包含一个 state 字段,筛选器要排除任何 state 字段等于“Washington”的项。当 state 等于“Washington”的项发生变更,使 state 等于“Oregon”时,该项将移入筛选器。

表示跟踪筛选器的副本的目标提供程序必须调用此方法,才能检索有关应用于目标副本的每个变更的更新信息。

请参阅

参考

IFilterTrackingSaveChangeContext 接口