Метод IPortableDeviceValues::GetBufferValue

Метод GetBufferValue извлекает значение массива байтов (тип VT_VECTOR | VT_UI1), указанный ключом.

Синтаксис

HRESULT GetBufferValue(
  [in]  REFPROPERTYKEY key,
  [out] BYTE           **ppValue,
  [out] DWORD          *pcbValue
);

Параметры

key [in]

Ключ REFPROPERTYKEY , указывающий извлекаемый элемент.

ppValue [out]

Указатель на полученное значение BYTE* . Вызывающий объект отвечает за освобождение памяти путем вызова CoTaskMemFree.

pcbValue [out]

Указатель на размер ppValue в байтах.

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.
DISP_E_TYPEMISMATCH	Свойство, указанное ключом , не является типом BYTE*.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Свойство, указанное ключом , отсутствует в коллекции.

Комментарии

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

Требования

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

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

Интерфейс IPortableDeviceValues

IPortableDeviceValues::SetBufferValue