QueueGetValuesByObjectList 方法将来自设备上的一个或多个指定对象的一个或多个指定属性的请求排队。
语法
HRESULT QueueGetValuesByObjectList(
  [in]  IPortableDevicePropVariantCollection  *pObjectIDs,
  [in]  IPortableDeviceKeyCollection          *pKeys,
  [in]  IPortableDevicePropertiesBulkCallback *pCallback,
  [out] GUID                                  *pContext
);
参数
[in] pObjectIDs
指向 IPortableDevicePropVariantCollection 接口的指针,该接口列出了要查询的所有对象的对象 ID。 这些类型为 VT_LPWSTR。
[in] pKeys
指向 IPortableDeviceKeyCollection 接口的指针,该接口指定要请求的属性。 有关 Windows 可移植设备定义的属性列表,请参阅 属性和属性。 指定 NULL 以指示指定对象中的所有属性。
[in] pCallback
指向应用程序实现的 IPortableDevicePropertiesBulkCallback 接口的指针,该接口将在检索信息时接收信息。
[out] pContext
指向 GUID 的指针,该 GUID 用于启动、取消或标识请求 IPortableDevicePropertiesBulkCallback 回调(如果已实现)。
返回值
该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。
| 返回代码 | 说明 | 
|---|---|
  | 
方法成功。 | 
注解
在 应用程序调用 Start 之前,不会启动排队的请求。 有关如何使用此方法的详细信息,请参阅 IPortableDevicePropertiesBulk 接口。
由于性能问题,当 pKeys 参数为 NULL 时,某些设备可能不会返回完整的属性列表。
要求
| 要求 | 值 | 
|---|---|
| 目标平台 | Windows | 
| 标头 | portabledeviceapi.h | 
| Library | PortableDeviceGUIDs.lib |