IPortableDeviceProperties::GetValues-Methode (portabledeviceapi.h)

Artikel
03/04/2024

Die GetValues-Methode ruft eine Liste der angegebenen Eigenschaften aus einem angegebenen Objekt auf einem Gerät ab.

Syntax

HRESULT GetValues(
  [in]  LPCWSTR                      pszObjectID,
  [in]  IPortableDeviceKeyCollection *pKeys,
  [out] IPortableDeviceValues        **ppValues
);

Parameter

[in] pszObjectID

Zeiger auf eine NULL-Zeichenfolge, die die ID des abzufragenden Objekts enthält. Verwenden Sie zum Angeben des Geräts WPD_DEVICE_OBJECT_ID.

[in] pKeys

Zeiger auf eine IPortableDeviceKeyCollection-Schnittstelle , die eine oder mehrere Eigenschaften zum Abfragen enthält. Wenn dies NULL ist, werden alle Eigenschaften abgerufen. Eine Liste der Eigenschaften, die von tragbaren Windows-Geräten definiert werden, finden Sie unter Eigenschaften und Attribute .

[out] ppValues

Adresse einer Variablen, die einen Zeiger auf eine IPortableDeviceValues-Schnittstelle empfängt , die die angeforderten Eigenschaftswerte enthält. Diese werden als PROPERTYKEY/Wert-Paare zurückgegeben, wobei der Datentyp des Werts von der -Eigenschaft abhängt. Wenn ein Wert aus irgendeinem Grund nicht abgerufen werden konnte, wird der zurückgegebene Typ VT_ERROR und enthält einen HRESULT-Wert, der den Abruffehler beschreibt. Der Aufrufer muss diese Schnittstelle freigeben, wenn sie damit fertig ist.

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	Alle angeforderten Eigenschaftswerte wurden abgerufen.
S_FALSE	Mindestens ein Eigenschaftswert konnte nicht abgerufen werden. Die Problemeigenschaften weisen im abgerufenen ppValues-Parameter einen HRESULT-Wert auf.