IPortableDevicePropertiesBulk::QueueGetValuesByObjectList-Methode (portabledeviceapi.h)

Die QueueGetValuesByObjectList-Methode stellt eine Anforderung für eine oder mehrere angegebene Eigenschaften aus einem oder mehreren angegebenen Objekten auf dem Gerät in die Warteschlange.

Syntax

HRESULT QueueGetValuesByObjectList(
  [in]  IPortableDevicePropVariantCollection  *pObjectIDs,
  [in]  IPortableDeviceKeyCollection          *pKeys,
  [in]  IPortableDevicePropertiesBulkCallback *pCallback,
  [out] GUID                                  *pContext
);

Parameter

[in] pObjectIDs

Zeiger auf eine IPortableDevicePropVariantCollection-Schnittstelle , die die Objekt-IDs aller abzufragenden Objekte auflistet. Diese sind vom Typ VT_LPWSTR.

[in] pKeys

Zeiger auf eine IPortableDeviceKeyCollection-Schnittstelle , die die anzufordernden Eigenschaften angibt. Eine Liste der eigenschaften, die von tragbaren Windows-Geräten definiert werden, finden Sie unter Eigenschaften und Attribute. Geben Sie NULL an, um alle Eigenschaften der angegebenen Objekte anzugeben.

[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 verwendet wird, um die IPortableDevicePropertiesBulkCallback-Rückrufe zu starten, abzubrechen oder zu identifizieren, sofern implementiert.

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	Die Methode wurde erfolgreich ausgeführt.

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.

Aufgrund von Leistungsproblemen geben einige Geräte möglicherweise keine umfassende Liste von Eigenschaften zurück, wenn der pKeys-ParameterNULL ist.

Anforderungen

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

Weitere Informationen

IPortableDevicePropertiesBulk-Schnittstelle

IPortableDevicePropertiesBulk::QueueSetValuesByObjectList