IItemMetadata::GetGlobalId
Obtém a ID global do item.
HRESULT GetGlobalId(
BYTE * pbGlobalId,
ULONG * pcbGlobalId);
Parâmetros
- pbGlobalId
[in, out, size_is(*pcbGlobalId), unique] Retorna a ID global do item.
- pcbGlobalId
[in, out] Especifica o número de bytes em pbGlobalId. Retorna o número de bytes necessários para recuperar a ID global quando pbGlobalId é muito pequeno; caso contrário, retorna o número de bytes gravados.
Valor de retorno
S_OK.
S_FALSE se a ID global não estiver definida.
E_POINTER.
HRESULT_FROM_WIN32(ERROR_MORE_DATA) quando pbGlobalId não for grande o suficiente para receber o valor do campo. Nesse caso, pcbGlobalId retorna o número necessário de bytes.
Comentários
A ID global identifica o item exclusivamente ao longo do escopo de sincronização.
O formato da ID retornada depende do esquema de formato de ID especificado quando a réplica foi inicializada. Para obter informações sobre formatos de ID, consulte Requisitos de metadados para provedores padrão.
Se IItemMetadata::SetGlobalId foi chamado para definir o valor de ID global, mas a alteração ainda não foi salva por uma chamada para IReplicaMetadata::SaveItemMetadata, GetGlobalId retornará o valor contido no objeto IItemMetadata e não o valor armazenado no repositório de metadados.