IPortableDevicePropertiesBulkCallback::OnProgress 方法 (portabledeviceapi.h)

IPortableDevicePropertiesBulk::Start 启动的批量操作已将数据发送到设备并接收回一些信息时,SDK 将调用 OnProgress 方法。

语法

HRESULT OnProgress(
  [in] REFGUID                         pContext,
  [in] IPortableDeviceValuesCollection *pResults
);

参数

[in] pContext

指向 GUID 的指针,该 GUID 标识正在进行的操作。 此值由 队列生成... IPortableDevicePropertiesBulk 接口的 方法。

[in] pResults

指向包含从设备检索到的结果的 IPortableDeviceValuesCollection 接口的指针。 此接口将保存一个或多个 IPortableDeviceValues 接口。 其中每个接口将保存一个 具有 字符串值的WPD_OBJECT_ID属性, (VT_LPSTR) 指定这些值与之相关的对象的对象 ID。 每个 IPortableDeviceValues 接口中的其余值会有所不同,具体取决于报告的批量操作。 对于 QueueGetValuesByObjectFormatQueueGetValuesByObjectList 方法,它们将被检索到不同类型的值。 对于 QueueSetValuesByObjectList,将为设置值时遇到的任何错误 VT_ERRORHRESULT 值。

返回值

应用程序应返回S_OK或错误代码以放弃操作。 所有错误代码的处理方式相同。

注解

此方法可以调用一次或多次,具体取决于操作的大小。

此方法不一定一次性检索所有属性,也不一定按特定顺序返回属性。

如果多次调用此方法,它可能会每次返回同一对象标识符的属性。

要求

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

另请参阅

IPortableDevicePropertiesBulkCallback 接口