IItemMetadata2::GetMergeWinnerId
Obtém o valor da ID vencedora de uma marca de exclusão de mesclagem.
HRESULT GetMergeWinnerId(
BYTE * pbWinnerId,
ULONG * pcbWinnerId);
Parâmetros
- pbWinnerId
[in, out, size_is(*pcbWinnerId), unique] Retorna o valor da ID vencedora de uma marca de exclusão de mesclagem.
- pcbWinnerId
[in, out] Especifica o número de bytes em pbWinnerId. Retorna o número de bytes necessários para recuperar a ID quando pbWinnerId é muito pequeno, ou retorna o número de bytes gravados.
Valor de retorno
S_OK.
S_FALSE quando este item não for uma marca de exclusão de mesclagem.
E_POINTER.
HRESULT_FROM_WIN32(ERROR_MORE_DATA) quando pbWinnerId for muito pequeno. Nesse caso, o número de bytes necessário será retornado em pcbWinnerId.
Comentários
Uma marca de exclusão de mesclagem é criada quando um conflito de restrição é resolvido por meio da mesclagem de dois itens em conflito. Quando um conflito de restrição é resolvido por mesclagem, a menor das IDs de item é escolhida como a ID vencedora e a maior é a ID de item perdedora. A ID de item vencedora é usada para identificar o item mesclado. A marca de exclusão de mesclagem controla se a ID de item perdedora identifica o mesmo item que a ID de item vencedora na comunidade de sincronização. Os metadados de uma marca de exclusão de mesclagem são iguais aos de uma marca de exclusão de item excluído, com a adição da ID de item vencedora.