Freigeben über


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.

Siehe auch

Verweis

IProviderFilteredSyncServices-Schnittstelle