ISyncChangeBatch2::AddMergeTombstoneMetadataToGroup
Fügt der gegenwärtig geöffneten Gruppe den angegebenen Mergetombstone hinzu.
HRESULT AddMergeTombstoneMetadataToGroup(
const BYTE * pbOwnerReplicaId,
const BYTE * pbWinnerItemId,
const BYTE * pbItemId,
const SYNC_VERSION * pChangeVersion,
const SYNC_VERSION * pCreationVersion,
DWORD dwWorkForChange,
ISyncChangeBuilder ** ppChangeBuilder);
Parameter
- pbOwnerReplicaId
[in] Die Replikat-ID des Replikats, in dem pChangeVersion und pCreationVersion gültig sind. Das ID-Format muss mit dem Format übereinstimmen, das von der ID_PARAMETERS-Struktur des Anbieters angegeben wird.
- pbWinnerItemId
[in] Die ID des Elements nach der Zusammenführung. Sie wird auch als vorrangige ID bezeichnet. Das ID-Format muss mit dem Format übereinstimmen, das von der ID_PARAMETERS-Struktur des Anbieters angegeben wird.
- pbItemId
[in] Die ID des Elements vor der Zusammenführung. Sie wird auch als nachrangige ID bezeichnet. Das ID-Format muss mit dem Format übereinstimmen, das von der ID_PARAMETERS-Struktur des Anbieters angegeben wird.
- pChangeVersion
[in] Die Version dieser Änderung.
- pCreationVersion
[in] Die Erstellungsversion des Elements, das durch pbItemId identifiziert wird.
- dwWorkForChange
[in] Die geschätzte Arbeit für die Änderung. Dieser Wert wird während der Anwendungsänderung verwendet, um der Anwendung die abgeschlossene Arbeit zu melden.
- ppChangeBuilder
[in, out, unique] Gibt ein Objekt zurück, das verwendet werden kann, um der Änderung Informationen über die Änderungseinheit hinzuzufügen.
Rückgabewert
S_OK.
E_POINTER.
SYNC_E_CHANGE_BATCH_IS_READ_ONLY, wenn das ISyncChangeBatch2-Objekt an einen Änderungsanwender oder an die Synchronisierungssitzung gesendet wurde oder wenn das Objekt mithilfe von IProviderSyncServices::DeserializeChangeBatch oder IProviderSyncServices::DeserializeFullEnumerationChangeBatch erstellt wurde.
SYNC_E_INVALID_OPERATION, wenn keine Gruppe geöffnet ist oder wenn zuvor dem Batch eine leere Gruppe hinzugefügt wurde.
SYNC_E_RANGE_OUT_OF_ORDER, wenn eine geordnete Gruppe geöffnet ist und pbItemId kleiner als die Element-ID des vorherigen der Gruppe hinzugefügten Elements oder kleiner als die Element-ID ist, die beim Öffnen der Gruppe angegeben wurde.
Hinweise
Ein Mergetombstone wird erstellt, wenn ein Einschränkungskonflikt aufgelöst wird, indem die zwei in Konflikt stehenden Elemente zusammengeführt werden. Wird ein Einschränkungskonflikt durch eine Zusammenführung aufgelöst, wird die kleinere Element-ID als vorrangige und die größere Element-ID als nachrangige gewählt. Das zusammengeführte Element wird anhand der vorrangigen Element-ID identifiziert. Der Mergetombstone verfolgt nach, ob von der nachrangigen Element-ID in der Synchronisierungscommunity dasselbe Element wie von der vorrangigen Element-ID identifiziert wird. Die Metadaten für einen Mergetombstone sind abgesehen von der vorrangigen Element-ID mit denen eines Tombstones für ein gelöschtes Element identisch.
Siehe auch
Verweis
ISyncChangeBatch2-Schnittstelle