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”时,该项将移入筛选器。
表示跟踪筛选器的副本的目标提供程序必须调用此方法,才能检索有关应用于目标副本的每个变更的更新信息。