IItemMetadata::GetGlobalId
Возвращает глобальный идентификатор элемента.
HRESULT GetGlobalId(
BYTE * pbGlobalId,
ULONG * pcbGlobalId);
Параметры
- pbGlobalId
[in, out, size_is(*pcbGlobalId), unique] Возвращает глобальный идентификатор элемента.
- pcbGlobalId
[in, out] Указывает число байтов в объекте pbGlobalId. Возвращает число байтов, необходимое для получения глобального идентификатора, если размер pbGlobalId слишком мал. В противном случае возвращает число записанных байтов.
Возвращаемое значение
S_OK.
S_FALSE, если глобальный идентификатор не задан.
E_POINTER.
HRESULT_FROM_WIN32(ERROR_MORE_DATA), если pbGlobalId имеет недостаточный размер, чтобы вместить значение поля. В этом случае параметр pcbGlobalId возвращает необходимое число байтов.
Замечания
Глобальный идентификатор уникально определяет элемент в пределах всей области синхронизации.
Формат возвращаемого идентификатора зависит от схемы формата идентификатора, заданной в момент инициализации реплики. Сведения о форматах идентификаторов см. в разделе Требования к метаданным для стандартных поставщиков.
Если установка значения глобального идентификатора производилась путем вызова метода IItemMetadata::SetGlobalId, но изменение еще не сохранено с помощью вызова метода IReplicaMetadata::SaveItemMetadata, то метод GetGlobalId возвращает значение, содержащееся в объекте IItemMetadata, а не значение из хранилища метаданных.