IItemMetadata2::GetMergeWinnerId
Obtient la valeur d'ID gagnant d'un objet tombstone de fusion.
HRESULT GetMergeWinnerId(
BYTE * pbWinnerId,
ULONG * pcbWinnerId);
Paramètres
- pbWinnerId
[in, out, size_is(*pcbWinnerId), unique] Retourne la valeur d'ID gagnant d'un objet tombstone de fusion.
- pcbWinnerId
[in, out] Spécifie le nombre d'octets contenus dans pbWinnerId. Retourne le nombre d'octets requis pour récupérer l'ID lorsque pbWinnerId est trop petit, ou le nombre d'octets écrits.
Valeur de retour
S_OK.
S_FALSE lorsque cet élément n'est pas un objet tombstone de fusion.
E_POINTER.
HRESULT_FROM_WIN32(ERROR_MORE_DATA) lorsque pbWinnerId est trop petit. Dans ce cas, le nombre requis d'octets est retourné dans pcbWinnerId.
Notes
Un objet tombstone de fusion est créé lorsqu'un conflit de contraintes est résolu en fusionnant les deux éléments en conflit. Lorsqu'un conflit de contraintes est résolu par une fusion, le plus petit des ID d'élément est choisi comme ID d'élément gagnant et le plus grand comme ID d'élément perdant. L'ID d'élément gagnant est utilisé pour identifier l'élément fusionné. L'objet tombstone de fusion détecte que l'ID d'élément perdant identifie le même élément que l'ID d'élément gagnant dans la communauté de synchronisation. Les métadonnées d'un objet tombstone de fusion sont les mêmes que pour un objet tombstone d'élément supprimé, avec en plus l'ID d'élément gagnant.