Метод IPortableDeviceCapabilities::GetSupportedFormatProperties (portabledeviceapi.h)
Метод GetSupportedFormatProperties извлекает свойства, поддерживаемые объектами указанного формата на устройстве.
Синтаксис
HRESULT GetSupportedFormatProperties(
[in] REFGUID Format,
[out] IPortableDeviceKeyCollection **ppKeys
);
Параметры
[in] Format
REFGUID, указывающий формат объекта . Список форматов, определенных переносными устройствами Windows, см. в разделе Форматы объектов.
[out] ppKeys
Адрес переменной, получающей указатель на интерфейс IPortableDeviceKeyCollection , содержащий поддерживаемые свойства для указанного формата. Список свойств, определенных переносными устройствами Windows, см. в разделе Свойства и атрибуты. Вызывающий объект должен освободить этот интерфейс после завершения работы с ним.
Возвращаемое значение
Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.
| Код возврата | Описание |
|---|---|
|
Метод выполнен успешно. |
Комментарии
Можно указать WPD_OBJECT_FORMAT_ALL для параметра Format , чтобы получить полный набор атрибутов свойства.
Если объекту не присвоено значение определенного свойства или свойство было удалено, устройство может вообще не сообщать о свойстве при перечислении его свойств. Другое устройство может сообщить о свойстве, но с пустой строкой или значением, равным нулю. Чтобы избежать такого несоответствия, можно вызвать этот метод, чтобы узнать все свойства, которые можно задать для определенного объекта.
Требования
| Целевая платформа | Windows |
| Header | portabledeviceapi.h |
| Библиотека | PortableDeviceGUIDs.lib |