IItemMetadata::SetFieldByteArray

Задает значение поля байтового массива.

HRESULT SetFieldByteArray(
  LPCWSTR pcszFieldName,
  BYTE * pbValue,
  ULONG cbValue);

Параметры

• pcszFieldName
  [in, string] Имя поля.

• pbValue
  [in, unique, size_is(cbValue)] Значение поля.

• cbValue
  [in] Число байтов в pbValue.

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

• S_OK.

• E_POINTER.

• E_INVALIDARG.

• SYNC_E_METADATA_FIELD_INVALID_NAME, если поле не существует.

• SYNC_E_METADATA_FIELD_INVALID_TYPE, если тип поля отличен от массива байт.

Замечания

Значение поля можно сбросить (заменить пустым значением), задав значение NULL в параметре pbValue и значение 0 в параметре cbValue. Если параметр pbValue установлен в значение NULL, а значение параметра cbValue отлично от 0 либо если параметр cbValue имеет значение 0, а значение параметра pbValue отлично от NULL, то возвращается значение E_INVALIDARG.

Примечание.
Этот метод не сохраняет изменение в хранилище. Необходимо вызвать метод IReplicaMetadata::SaveItemMetadata, чтобы сохранить все изменения в свойствах объекта IItemMetadata.

См. также

Справочник

Интерфейс IItemMetadata