IProviderFilteredSyncServices::CreateFilterInfo
Crea un oggetto ISyncFilterInfo che può essere utilizzato da un provider di origine per comunicare informazioni sul filtro utilizzato per stabilire quali modifiche includere in un batch di modifiche.
HRESULT CreateFilterInfo(
DWORD dwFlags,
ISyncFilterInfo ** ppFilterInfo);
Parametri
- dwFlags
[in] Flag che specificano informazioni aggiuntive sull'oggetto informazioni sul filtro da creare. Deve essere SYNC_FILTER_INFO_FLAG_ITEM_LIST o SYNC_FILTER_INFO_FLAG_CHANGE_UNIT_LIST.
- ppFilterInfo
[out] Restituisce l'oggetto informazioni sul filtro appena creato.
Valore restituito
S_OK
E_INVALIDARG se dwFlags non è SYNC_FILTER_INFO_FLAG_ITEM_LIST o SYNC_FILTER_INFO_FLAG_CHANGE_UNIT_LIST.
E_OUTOFMEMORY
E_POINTER
SYNC_E_INVALID_OPERATION se questo oggetto non è stato inizializzato correttamente.
Osservazioni
Quando viene specificato SYNC_FILTER_INFO_FLAG_ITEM_LIST per il valore dwFlags, Sync Framework restituisce un oggetto che implementa ISyncFilterInfo. L'implementazione fornita da questo oggetto serializza le informazioni sulla versione e i flag specificati per dwFlags quando viene chiamato il metodo ISyncFilterInfo::Serialize relativo.
Quando viene specificato SYNC_FILTER_INFO_FLAG_CHANGE_UNIT_LIST per il valore dwFlags, Sync Framework restituisce un oggetto che implementa IChangeUnitListFilterInfo. L'implementazione fornita da questo oggetto può essere utilizzata per specificare che per gli elementi di un batch di modifiche venga incluso solo un particolare set di unità di modifica.