ISyncChangeWithFilterKeyMap::GetFilterChange

获取一个指示该项是否已位于指定筛选器中的值。

HRESULT GetFilterChange(
  DWORD   dwFilterKey,
  SYNC_FILTER_CHANGE * pFilterChange);

参数

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

返回值

  • S_OK。

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

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

  • E_POINTER。

  • 如果不跟踪指定的筛选器,则返回值为 SYNC_E_SOURCE_DOES_NOT_TRACK_FILTER。

备注

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

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

请参阅

参考

ISyncChangeWithFilterKeyMap 接口