IProviderFilteredSyncServices::CreateFilterInfo
创建一个 ISyncFilterInfo 对象,源提供程序可以使用该对象来传递有关用于控制要将哪些变更包括在变更批中的筛选器的信息。
HRESULT CreateFilterInfo(
DWORD dwFlags,
ISyncFilterInfo ** ppFilterInfo);
参数
- dwFlags
[in] 指定有关要创建的筛选器信息对象的其他信息的标志。必须为 SYNC_FILTER_INFO_FLAG_ITEM_LIST 或 SYNC_FILTER_INFO_FLAG_CHANGE_UNIT_LIST。
- ppFilterInfo
[out] 返回新创建的筛选器信息对象。
返回值
S_OK
如果 dwFlags 不是 SYNC_FILTER_INFO_FLAG_ITEM_LIST 或 SYNC_FILTER_INFO_FLAG_CHANGE_UNIT_LIST,则返回值为 E_INVALIDARG。
E_OUTOFMEMORY
E_POINTER
如果尚未正确初始化此对象,则返回值为 SYNC_E_INVALID_OPERATION。
备注
在为 dwFlags 值指定 SYNC_FILTER_INFO_FLAG_ITEM_LIST 时,Sync Framework 返回实现 ISyncFilterInfo 的对象。此对象提供的实现可序列化在调用其 ISyncFilterInfo::Serialize 方法时为 dwFlags 指定的版本信息和标志。
在为 dwFlags 值指定 SYNC_FILTER_INFO_FLAG_CHANGE_UNIT_LIST 时,Sync Framework 将返回实现 IChangeUnitListFilterInfo 的对象。此对象提供的实现可用于指定仅为变更批中的项包括特定的变更单位集。