Метод IPortableDeviceValues::SetBufferValue

  • Статья

Метод SetBufferValue добавляет новое значение BYTE* (тип VT_VECTOR | VT_UI1) или перезаписывает существующий.

Синтаксис

HRESULT SetBufferValue(
  [in] REFPROPERTYKEY key,
  [in] BYTE           *pValue,
  [in] DWORD          cbValue
);

Параметры

key [in]

REFPROPERTYKEY, указывающий элемент для создания или перезаписи.

pValue [in]

ОБЪЕКТ BYTE*, содержащий данные для записи в элемент. Отправленные данные буфера копируются в интерфейс, поэтому вызывающий объект может освободить этот буфер после выполнения этого вызова.

cbValue [in]

Размер значения, на которое указывает pValue, в байтах.

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

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата Описание
S_OK
 Метод выполнен успешно.

Комментарии

Если существующее значение имеет тот же ключ, что и параметр key , оно перезаписывает существующее значение без каких-либо предупреждений. Существующая память ключа освобождается соответствующим образом.

Установка значения NULL или нулевого размера буфера не поддерживается.

Требования

Требование Значение
Заголовок
PortableDeviceTypes.h
Библиотека
PortableDeviceGUIDs.lib

См. также раздел

Интерфейс IPortableDeviceValues

IPortableDeviceValues::GetBufferValue