IItemMetadata::TryGetFieldUInt8
Возвращает значение 8-разрядного беззнакового целочисленного поля.
HRESULT TryGetFieldUInt8(
LPCWSTR pcszFieldName,
BYTE * pbValue);
Параметры
- pcszFieldName
[in, string] Имя поля.
- pbValue
[out] Возвращает значение указанного поля.
Возвращаемое значение
S_OK
S_FALSE, если значение не задано.
E_POINTER
E_INVALIDARG
SYNC_E_METADATA_FIELD_INVALID_NAME, если поле не существует.
SYNC_E_METADATA_FIELD_INVALID_TYPE, если тип поля не является 8-разрядным беззнаковым целым.
Замечания
Пользовательские поля должны быть определены с помощью структуры CUSTOM_FIELD_DEFINITION при первой инициализации метаданных реплики.
Если установка значения поля производилась вызовом метода IItemMetadata::SetFieldUInt8, но изменение еще не сохранено вызовом метода IReplicaMetadata::SaveItemMetadata, то TryGetFieldUInt8 возвращает значение, содержащееся в объекте IItemMetadata, а не значение из хранилища метаданных.