IItemMetadata2::GetMergeWinnerId

Возвращает значение идентификатора победившей отметки полного удаления слиянием.

HRESULT GetMergeWinnerId(
  BYTE * pbWinnerId,
  ULONG * pcbWinnerId);

Параметры

• pbWinnerId
  [in, out, size_is(*pcbWinnerId), unique] Возвращает значение выигравшего идентификатора отметки полного удаления слиянием.

• pcbWinnerId
  [in, out] Указывает число байтов в объекте pbWinnerId. Возвращает число байтов, необходимое для получения идентификатора, если размер pbWinnerId слишком мал, либо возвращает число записанных байтов.

Возвращаемое значение

• S_OK.

• S_FALSE, если данный элемент не является отметкой полного удаления слиянием.

• E_POINTER.

• HRESULT_FROM_WIN32(ERROR_MORE_DATA), если размер pbWinnerId слишком мал. В этом случае необходимое число байтов возвращается в параметре pcbWinnerId.

Замечания

Отметка полного удаления слиянием создается в том случае, если конфликт ограничения разрешен слиянием двух конфликтующих элементов. Если конфликт ограничений разрешается путем слияния, то в качестве выигравшего выбирается элемент с наименьшим идентификатором, а в качестве проигравшего — с наибольшим. Для объединенного элемента используется идентификатор выигравшего элемента. Отметка полного удаления слиянием отслеживает, чтобы идентификатор проигравшего элемента указывал на тот же элемент, что и идентификатор победителя в сообществе синхронизации. Отметка полного удаления слиянием имеет те же метаданные, что и отметка полного удаления для удаленного элемента, плюс идентификатор элемента победителя.

См. также

Справочник

Интерфейс IItemMetadata2

Основные положения

Обнаружение и разрешение конфликтов ограничений