IChangeApplicationServices::GetChangeApplicationContext
Ruft ein Objekt ab, das die aktuell zu übernehmende Änderung darstellt.
HRESULT GetChangeApplicationContext(
ISyncChange * pSourceChange,
ISyncChange * pDestinationVersion,
IChangeApplicationContext ** ppContext);
Parameter
- pSourceChange
[in, unique] Eine vom Quellenanbieter empfangene Änderung. Der Wert kann NULL sein, wenn der Änderungsbatch Teil einer Wiederherstellungssynchronisierung ist.
- pDestinationVersion
[in, unique] Die Version von pSourceChange im Zielreplikat. Der Wert kann NULL sein, wenn das Zielreplikat keine Version für pSourceChange aufweist.
- ppContext
[out] Gibt ein Objekt zurück, mit dem die Änderung verarbeitet werden kann.
Rückgabewert
S_OK.
E_OUTOFMEMORY.
E_POINTER.
SYNC_E_ACTIVE_CHANGE_APPLICATION_CONTEXT, wenn ein IChangeApplicationContext-Objekt bereits aktiv ist. Das aktive IChangeApplicationContext-Objekt muss verarbeitet werden, bis seine IChangeApplicationContext::GetChangeApplicationAction-Methode CAA_FINISHED zurückgibt, bevor eine andere Änderung verarbeitet werden kann.
SYNC_E_CHANGE_NEEDS_KNOWLEDGE, wenn pSourceChange kein Anwendungswissen enthält.
SYNC_E_CHANGE_NOT_IN_KNOWLEDGE, wenn die Updateversion oder die Erstellungsversion von pSourceChange nicht in dessen Anwendungswissen enthalten ist.
SYNC_E_CHANGE_UNIT_COUNT_MISMATCH, wenn pSourceChange und pDestinationVersion eine unterschiedliche Anzahl von Änderungseinheiten enthalten.
SYNC_E_ID_FORMAT_MISMATCH, wenn das Format einer angegebenen ID nicht dem ID-Formatschema entspricht, das bei der Initialisierung dieses Objekts angegeben wurde.
SYNC_E_INVALID_OPERATION, wenn die Änderungsanwendung nicht für einen Änderungsbatch gestartet wurde oder wenn pSourceChange bereits als erfolgreich übernommen gemeldet wurde.
SYNC_E_ITEM_HAS_CHANGE_UNITS, wenn entweder nur pSourceChange oder nur pDestinationVersion Änderungseinheiten enthält.
SYNC_E_NOT_EXPECTED_CHANGE, wenn pSourceChange und pDestinationVersion auf verschiedene Element-IDs verweisen.
Hinweise
Diese Methode wird vom Zielanbieter in der Regel einmal für jede Änderung aufgerufen, die vom Quellenanbieter gesendet wird. Das zurückgegebene IChangeApplicationContext-Objekt kann verwendet werden, um Konflikterkennung und Konfliktauflösung durchzuführen und zu bestimmen, wie der Zielanbieter die durch pSourceChange angegebene Änderung übernehmen sollte.