IPortableDeviceCapabilities::GetSupportedFormatProperties 方法 (portabledeviceapi.h)

GetSupportedFormatProperties 方法检索设备上指定格式的对象支持的属性。

语法

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

parameters

[in] Format

指定对象格式的 REFGUID 。 有关 Windows 可移植设备定义的格式的列表,请参阅 对象格式

[out] ppKeys

接收指向 IPortableDeviceKeyCollection 接口的指针的变量的地址,该接口包含指定格式支持的属性。 有关 Windows 可移植设备定义的属性列表,请参阅 属性和属性。 调用方在使用完此接口后必须释放此接口。

返回值

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

返回代码 说明
S_OK
方法成功。

注解

可以为 Format 参数指定WPD_OBJECT_FORMAT_ALL,以检索完整的属性属性集。

如果对象没有分配给特定属性的值,或者如果该属性已被删除,则设备在枚举其属性时可能根本不报告该属性。 另一个设备可能会报告属性,但具有空字符串或值为零。 为了避免这种不一致,可以调用此方法来了解可以在特定对象上设置的所有属性。

要求

   
目标平台 Windows
标头 portabledeviceapi.h
Library PortableDeviceGUIDs.lib

请参阅

IPortableDeviceCapabilities 接口

IPortableDeviceCapabilities::GetSupportedFormats