IPortableDevicePropertiesBulkCallback::OnProgress-Methode (portabledeviceapi.h)

Die OnProgress-Methode wird vom SDK aufgerufen, wenn ein Massenvorgang von IPortableDevicePropertiesBulk::Start Daten an das Gerät gesendet und einige Informationen zurückerhalten hat.

Syntax

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

Parameter

[in] pContext

Zeiger auf eine GUID, die den laufenden Vorgang identifiziert. Dieser Wert wird von einer Warteschlange erzeugt... -Methode der IPortableDevicePropertiesBulk-Schnittstelle .

[in] pResults

Zeiger auf eine IPortableDeviceValuesCollection-Schnittstelle , die die vom Gerät abgerufenen Ergebnisse enthält. Diese Schnittstelle enthält mindestens eine IPortableDeviceValues-Schnittstelle . Jede dieser Schnittstellen enthält eine WPD_OBJECT_ID Eigenschaft mit einem Zeichenfolgenwert (VT_LPSTR), der die Objekt-ID des Objekts angibt, auf das sich diese Werte beziehen. Die restlichen Werte in jeder IPortableDeviceValues-Schnittstelle variieren je nach dem gemeldeten Massenvorgang. Für die Methoden QueueGetValuesByObjectFormat und QueueGetValuesByObjectList werden werte unterschiedlicher Typen abgerufen. Für QueueSetValuesByObjectList sind sie VT_ERRORHRESULT-Werte für alle Fehler beim Festlegen von Werten.

Rückgabewert

Die Anwendung sollte entweder S_OK oder einen Fehlercode zurückgeben, um den Vorgang abzubrechen. Alle Fehlercodes werden auf die gleiche Weise behandelt.

Hinweise

Diese Methode kann einmal oder mehrmals aufgerufen werden, je nachdem, wie groß der Vorgang ist.

Diese Methode ruft nicht notwendigerweise alle Eigenschaften auf einmal ab, noch gibt sie die Eigenschaften in einer bestimmten Reihenfolge zurück.

Wenn diese Methode mehrmals aufgerufen wird, gibt sie möglicherweise jedes Mal Eigenschaften für denselben Objektbezeichner zurück.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	portabledeviceapi.h
Bibliothek	PortableDeviceGUIDs.lib

Weitere Informationen

IPortableDevicePropertiesBulkCallback-Schnittstelle