IProviderFilteredSyncServices::CreateFilterInfo
Erstellt ein ISyncFilterInfo-Objekt, das von einem Quellenanbieter verwendet werden kann, um Informationen über den Filter zu übermitteln, mit dem gesteuert wird, welche Änderungen in einen Änderungsbatch eingeschlossen werden.
HRESULT CreateFilterInfo(
DWORD dwFlags,
ISyncFilterInfo ** ppFilterInfo);
Parameter
- dwFlags
[in] Flags, die zusätzliche Informationen über das zu erstellende Filterinformationsobjekt angeben. Diese muss SYNC_FILTER_INFO_FLAG_ITEM_LIST oder SYNC_FILTER_INFO_FLAG_CHANGE_UNIT_LIST lauten.
- ppFilterInfo
[out] Gibt das neu erstellte Filterinformationsobjekt zurück.
Rückgabewert
S_OK
E_INVALIDARG, wenn dwFlags nicht SYNC_FILTER_INFO_FLAG_ITEM_LIST oder SYNC_FILTER_INFO_FLAG_CHANGE_UNIT_LIST ist.
E_OUTOFMEMORY
E_POINTER
SYNC_E_INVALID_OPERATION, wenn dieses Objekt nicht ordnungsgemäß initialisiert wurde.
Hinweise
Wenn SYNC_FILTER_INFO_FLAG_ITEM_LIST für den dwFlags-Wert angegeben wird, gibt Sync Framework ein Objekt zurück, das ISyncFilterInfo implementiert. Die von diesem Objekt bereitgestellte Implementierung serialisiert Versionsinformationen und die für dwFlags angegebenen Flags, wenn die zugehörige ISyncFilterInfo::Serialize-Methode aufgerufen wird.
Wenn SYNC_FILTER_INFO_FLAG_CHANGE_UNIT_LIST für den dwFlags-Wert angegeben wird, gibt Sync Framework ein Objekt zurück, das IChangeUnitListFilterInfo implementiert. Mit der Implementierung, die von diesem Objekt bereitgestellt wird, kann angegeben werden, dass nur ein bestimmter Satz von Änderungseinheiten für Elemente in einen Änderungsbatch eingeschlossen wird.