IPortableDevicePropertiesBulk::QueueSetValuesByObjectList-Methode (portabledeviceapi.h)

Die QueueSetValuesByObjectList-Methode stellt eine Anforderung in die Warteschlange, um einen oder mehrere angegebene Werte für ein oder mehrere angegebene Objekte auf dem Gerät festzulegen.

Syntax

HRESULT QueueSetValuesByObjectList(
  [in]  IPortableDeviceValuesCollection       *pObjectValues,
  [in]  IPortableDevicePropertiesBulkCallback *pCallback,
  [out] GUID                                  *pContext
);

Parameter

[in] pObjectValues

Zeiger auf eine IPortableDeviceValuesCollection-Schnittstelle , die die Eigenschaften und Werte enthält, die für angegebene Objekte festgelegt werden sollen. Diese Schnittstelle enthält eine oder mehrere IPortableDeviceValues-Schnittstellen , die jeweils ein einzelnes Objekt darstellen. Jede IPortableDeviceValues-Schnittstelle enthält eine Sammlung von Schlüssel-Wert-Paaren, wobei der Schlüssel der PROPERTYKEY ist, der die Eigenschaft identifiziert, und der Wert ist ein Datentyp, der je nach Eigenschaft variiert. Jede IPortableDeviceValues-Schnittstelle enthält auch eine WPD_OBJECT_ID Eigenschaft, die das Objekt identifiziert, auf das diese Schnittstelle verweist.

[in] pCallback

Zeiger auf eine von der Anwendung implementierte IPortableDevicePropertiesBulkCallback-Schnittstelle , die die Informationen beim Abrufen empfängt.

[out] pContext

Zeiger auf eine GUID, die zum Starten, Abbrechen oder Identifizieren der Anforderung an alle vom Client implementierten IPortableDevicePropertiesBulkCallback-Rückrufe verwendet wird.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
Der Vorgang wurde erfolgreich in die Warteschlange gestellt.

Hinweise

Die Anforderung in der Warteschlange wird erst gestartet, wenn die Anwendung Start aufruft. Weitere Informationen zur Verwendung dieser Methode finden Sie unter IPortableDevicePropertiesBulk-Schnittstelle.

Anforderungen

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

Weitere Informationen

IPortableDevicePropertiesBulk-Schnittstelle

IPortableDevicePropertiesBulk::QueueGetValuesByObjectList