Метод IPortableDeviceResources::GetResourceAttributes (portabledeviceapi.h)

Статья
07/16/2024

Метод GetResourceAttributes извлекает все атрибуты из указанного ресурса в объекте.

Синтаксис

HRESULT GetResourceAttributes(
  [in]  LPCWSTR               pszObjectID,
  [in]  REFPROPERTYKEY        Key,
  [out] IPortableDeviceValues **ppResourceAttributes
);

Параметры

[in] pszObjectID

Указатель на строку, завершающую значение NULL, содержащую идентификатор объекта, на котором размещен ресурс.

[in] Key

REFPROPERTYKEY, указывающий, какой ресурс следует запрашивать.

[out] ppResourceAttributes

Указатель на указатель интерфейса IPortableDeviceValues, содержащий пары PROPERTYKEY/PROPVARIANT, описывающие каждый атрибут и его значение соответственно. Типы значений атрибутов различаются. Если свойство не удалось вернуть, значение возвращаемого свойства будет VT_ERROR, а PROPVARIANTэлемент scode будет содержать HRESULT этого конкретного сбоя.

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

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

Возвращаемый код	Описание
S_OK	Извлекаются все значения атрибутов.
S_FALSE	Не удалось получить одно или несколько значений атрибутов. Они будут иметь значения HRESULT типа VT_ERROR в полученном параметре ppResourceAttributes.
E_POINTER	По крайней мере один из обязательных аргументов указателя был NULL.

Замечания

Атрибуты ресурсов описывают права доступа, размер, формат и другие сведения, связанные с ресурсом. Например, атрибуты ресурса заметок звука на объекте изображения могут указывать скорость передачи, количество каналов и формат данных звука.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	portabledeviceapi.h
библиотеки	PortableDeviceGUIDs.lib

См. также

Интерфейс IPortableDeviceResources

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