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 的物件。此物件提供的實作會將呼叫 dwFlags 的 ISyncFilterInfo::Serialize 方法時對它指定的版本資訊和旗標序列化。
如果對 dwFlags 值指定了 SYNC_FILTER_INFO_FLAG_CHANGE_UNIT_LIST,Sync Framework 就會傳回實作 IChangeUnitListFilterInfo 的物件。此物件提供的實作可用來指定,只有項目的特定一組變更單位包含在變更批次中。