IPortableDeviceProperties：：GetValues 方法 (portabledeviceapi.h)

项目
03/01/2024

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 值。