Метод IPortableDeviceCapabilities::GetSupportedFormatProperties (portabledeviceapi.h)

Метод GetSupportedFormatProperties извлекает свойства, поддерживаемые объектами указанного формата на устройстве.

Синтаксис

HRESULT GetSupportedFormatProperties(
  [in]  REFGUID                      Format,
  [out] IPortableDeviceKeyCollection **ppKeys
);

Параметры

[in] Format

REFGUID, указывающий формат объекта . Список форматов, определенных переносными устройствами Windows, см. в разделе Форматы объектов.

[out] ppKeys

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

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

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

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

Комментарии

Можно указать WPD_OBJECT_FORMAT_ALL для параметра Format , чтобы получить полный набор атрибутов свойства.

Если объекту не присвоено значение определенного свойства или свойство было удалено, устройство может вообще не сообщать о свойстве при перечислении его свойств. Другое устройство может сообщить о свойстве, но с пустой строкой или значением, равным нулю. Чтобы избежать такого несоответствия, можно вызвать этот метод, чтобы узнать все свойства, которые можно задать для определенного объекта.

Требования

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

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

Интерфейс IPortableDeviceCapabilities

IPortableDeviceCapabilities::GetSupportedFormats