IItemMetadata2::GetMergeWinnerId
Ruft den Wert der vorrangigen ID eines Mergetombstones ab.
HRESULT GetMergeWinnerId(
BYTE * pbWinnerId,
ULONG * pcbWinnerId);
Parameter
- pbWinnerId
[in, out, size_is(*pcbWinnerId), unique] Gibt den Wert der vorrangigen ID eines Mergetombstones zurück.
- pcbWinnerId
[in, out] Gibt die Anzahl der Bytes in pbWinnerId an. Gibt die Anzahl der zum Abrufen der ID erforderlichen Bytes zurück, wenn pbWinnerId zu klein ist, oder gibt die Anzahl der geschriebenen Bytes zurück.
Rückgabewert
S_OK.
S_FALSE, wenn dieses Element kein Mergetombstone ist.
E_POINTER.
HRESULT_FROM_WIN32(ERROR_MORE_DATA), wenn pbWinnerId zu klein ist. In diesem Fall wird die erforderliche Anzahl von Bytes in pcbWinnerId zurückgegeben.
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.