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。 可能的值包括(但并不限于)下表中的项。
返回代码 | 说明 |
---|---|
|
已检索所有请求的属性值。 |
|
无法检索一个或多个属性值。 问题属性将在检索到的 ppValues 参数中具有 HRESULT 值。 |
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | portabledeviceapi.h |
Library | PortableDeviceGUIDs.lib |