Поделиться через

Метод IPortableDeviceValues::GetValue

  • Статья

Метод GetValue извлекает значение PROPVARIANT , указанное ключом.

Синтаксис

HRESULT GetValue(
  [in]  REFPROPERTYKEY key,
  [out] PROPVARIANT    *pValue
);

Параметры

key [in]

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

pValue [out]

Указатель на полученное значение PROPVARIANT . Вызывающий объект должен освободить память, вызвав PropVariantClear по завершении работы с ним.

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

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

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

Комментарии

Если параметр VARTYPE для pValue VT_VECTOR или VT_UI1, получение буфера нулевого или нулевого размера не поддерживается. Например, ни pValue.caub.pElems = NULL , ни pValue.caub.cElems = 0 не допускаются.

Этот метод можно использовать для получения значения любого типа из коллекции. Однако если вы заранее знаете тип значения, используйте один из специализированных методов получения этого интерфейса, чтобы избежать дополнительных затрат на работу со значениями PROPVARIANT напрямую.

Требования

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

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

Интерфейс IPortableDeviceValues

IPortableDeviceValues::RemoveValue

IPortableDeviceValues::SetValue