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