Метод IPortableDeviceProperties::GetPropertyAttributes (portabledeviceapi.h)

Статья
03/01/2024

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

Синтаксис

HRESULT GetPropertyAttributes(
  [in]  LPCWSTR               pszObjectID,
  [in]  REFPROPERTYKEY        Key,
  [out] IPortableDeviceValues **ppAttributes
);

Параметры

[in] pszObjectID

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

[in] Key

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

[out] ppAttributes

Адрес переменной, получающей указатель на интерфейс IPortableDeviceValues , содержащий извлеченные атрибуты свойства. Это пары PROPERTYKEY/value, где PROPERTYKEY является свойством, а тип данных значения зависит от конкретного свойства. Вызывающий объект должен освободить этот интерфейс после завершения работы с ним. Атрибуты, определенные переносными устройствами Windows, можно найти на странице Свойства и атрибуты .

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно, и все атрибуты были успешно извлечены.
S_FALSE	Можно получить только некоторые значения атрибутов. Другие не могут и будут содержать значение HRESULT типа VT_ERROR.
E_POINTER	Обязательный аргумент указателя — NULL.

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

Примеры

Пример использования этого метода см. в разделе Настройка свойств для одного объекта.

Требования

Требование	Значение
Целевая платформа	Windows
Header	portabledeviceapi.h
Библиотека	PortableDeviceGUIDs.lib

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

Интерфейс IPortableDeviceProperties

Задание свойств для одного объекта

Написание свойств content-object

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