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 接口中的其余值会有所不同,具体取决于报告的批量操作。 对于 QueueGetValuesByObjectFormat 和 QueueGetValuesByObjectList 方法,它们将被检索到不同类型的值。 对于 QueueSetValuesByObjectList,将为设置值时遇到的任何错误 VT_ERRORHRESULT 值。
返回值
应用程序应返回S_OK或错误代码以放弃操作。 所有错误代码的处理方式相同。
注解
此方法可以调用一次或多次,具体取决于操作的大小。
此方法不一定一次性检索所有属性,也不一定按特定顺序返回属性。
如果多次调用此方法,它可能会每次返回同一对象标识符的属性。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | portabledeviceapi.h |
Library | PortableDeviceGUIDs.lib |