IPortableDeviceProperties::GetValues 方法 (portabledeviceapi.h)

GetValues 方法从设备上的指定对象中检索指定属性的列表。

语法

HRESULT GetValues(
  [in]  LPCWSTR                      pszObjectID,
  [in]  IPortableDeviceKeyCollection *pKeys,
  [out] IPortableDeviceValues        **ppValues
);

参数

[in] pszObjectID

指向以 null 结尾的字符串的指针,该字符串包含要查询的对象 ID。 若要指定设备,请使用 WPD_DEVICE_OBJECT_ID。

[in] pKeys

指向 IPortableDeviceKeyCollection 接口的指针,该接口包含要查询的一个或多个属性。 如果为 NULL,则将检索所有属性。 有关 Windows 可移植设备定义的属性列表,请参阅 属性和属性

[out] ppValues

变量的地址,该变量接收指向包含所请求属性值的 IPortableDeviceValues 接口的指针。 这些值将作为 PROPERTYKEY/值对返回,其中值的数据类型取决于 属性。 如果由于某种原因无法检索值,则返回的类型将VT_ERROR,并包含描述检索错误的 HRESULT 值。 调用方在使用完此接口后必须释放此接口。

返回值

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

返回代码 说明
S_OK
已检索所有请求的属性值。
S_FALSE
无法检索一个或多个属性值。 问题属性将在检索到的 ppValues 参数中具有 HRESULT 值。

要求

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

另请参阅

IPortableDeviceProperties 接口

IPortableDeviceProperties::SetValues

检索 Content-Object 属性

检索单个对象的属性

检索设备支持的呈现功能