IItemMetadata2::GetMergeWinnerId
Obtiene el valor del identificador ganador de un marcador de exclusión de combinación.
HRESULT GetMergeWinnerId(
BYTE * pbWinnerId,
ULONG * pcbWinnerId);
Parámetros
- pbWinnerId
[in, out, size_is(*pcbWinnerId), unique] Devuelve el valor del identificador ganador de un marcador de exclusión de combinación.
- pcbWinnerId
[in, out] Especifica el número de bytes de pbWinnerId. Devuelve el número de bytes necesarios para recuperar el identificador si pbWinnerId es demasiado pequeño o devuelve el número de bytes escritos.
Valor devuelto
S_OK.
S_FALSE si este elemento no es un marcador de exclusión de la combinación.
E_POINTER.
HRESULT_FROM_WIN32(ERROR_MORE_DATA) si pbWinnerId es demasiado pequeño. En este caso, el número necesario de bytes se devuelve en pcbWinnerId.
Notas
Se crea un marcador de exclusión de la combinación cuando se resuelve un conflicto de restricción combinando los dos elementos en conflicto. Cuando un conflicto de restricción se resuelve mediante combinación, el más pequeño de los identificadores de elemento se selecciona como identificador de elemento ganador y el identificador más grande será el del perdedor. El identificador del elemento que ha ganado se utiliza para identificar el elemento combinado. El marcador de exclusión de combinación hace un seguimiento al identificador de elemento que ha perdido para comprobar que identifica al mismo elemento como identificador de elemento que ha ganado en la comunidad de sincronización. Los metadatos de un marcador de exclusión de combinación son los mismos que los del marcador de exclusión del elemento eliminado, con la salvedad de que se agrega el identificador de elemento ganador.