共用方式為

IPortableDevicePropertiesBulkCallback：：OnProgress 方法 (portabledeviceapi.h)

  • 發行項

當 IPortableDevicePropertiesBulk：：Start 啟動的大量作業傳送數據給裝置並收到一些資訊時，SDK 會呼叫 OnProgress 方法。

語法

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

參數

[in] pContext

識別進行中作業之 GUID 的指標。 此值是由 佇列所產生... IPortableDevicePropertiesBulk 介面的 方法。

[in] pResults

IPortableDeviceValuesCollection 介面的指標，其中包含從裝置擷取的結果。 此介面會保存一或多個 IPortableDeviceValues 介面。 這些介面都會保留一個 WPD_OBJECT_ID 屬性，其中一個具有字串值， (VT_LPSTR) 指定這些值所相關對象的物件識別碼。 每個 IPortableDeviceValues 介面中的其餘值會根據所報告的大量作業而有所不同。 針對 QueueGetValuesByObjectFormat 和 QueueGetValuesByObjectList 方法，它們將會擷取不同類型的值。 針對 QueueSetValuesByObjectList，這些值將會針對設定值時遇到的任何錯誤VT_ERROR HRESULT 值。

傳回值

應用程式應該會傳回S_OK，或傳回錯誤碼來放棄作業。 所有錯誤碼的處理方式都相同。

備註

視作業的大小而定，這個方法可以呼叫一次或多次。

這個方法不一定一次擷取所有屬性，也不會以特定順序傳回屬性。

如果多次呼叫這個方法，則每次可能會傳回相同對象標識碼的屬性。

規格需求

需求 值
目標平台 Windows
標頭 portabledeviceapi.h
程式庫 PortableDeviceGUIDs.lib

另請參閱

IPortableDevicePropertiesBulkCallback 介面