通过

IFilterTrackingSyncChangeBuilder::AddFilterChange

  • 项目

添加指示此变更导致项目是移动到指定筛选器中还是移动到指定筛选器外部的信息。

HRESULT AddFilterChange(
  DWORD                      dwFilterKey, 
  const SYNC_FILTER_CHANGE * pFilterChange);

参数

  • dwFilterIndex
    [in] 副本的筛选键映射中的筛选器索引。
  • pFilterChange
    [in] 有关相对于 dwFilterIndex 指定的筛选器的变更的信息。

返回值

  • S_OK。

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

  • E_OUTOFMEMORY。

  • E_POINTER。

  • 如果 dwFilterIndex 已存在筛选器变更信息，则返回值为 SYNC_E_INVALID_OPERATION。

备注

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

如果提供程序表示的是对筛选器进行跟踪的副本，则该提供程序必须调用此方法才能设置与枚举的每个变更有关的筛选器跟踪信息。

请参阅

参考

IFilterTrackingSyncChangeBuilder 接口