IPortableDeviceResources::GetResourceAttributes-Methode (portabledeviceapi.h)

Artikel
07/16/2024

Die GetResourceAttributes- Methode ruft alle Attribute einer angegebenen Ressource in einem Objekt ab.

Syntax

HRESULT GetResourceAttributes(
  [in]  LPCWSTR               pszObjectID,
  [in]  REFPROPERTYKEY        Key,
  [out] IPortableDeviceValues **ppResourceAttributes
);

Parameter

[in] pszObjectID

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die die Objekt-ID des Objekts enthält, das die Ressource hosten soll.

[in] Key

Ein REFPROPERTYKEY-, der angibt, welche Ressource abzufragen ist.

[out] ppResourceAttributes

Zeiger auf einen IPortableDeviceValues Schnittstellenzeiger, der PROPERTYKEY-/PROPVARIANT- Paare enthält, die jedes Attribut bzw. dessen Wert beschreiben. Die Werttypen der Attributwerte variieren. Wenn eine Eigenschaft nicht zurückgegeben werden konnte, wird der Wert für die zurückgegebene Eigenschaft VT_ERROR, und der PROPVARIANTscode Member enthält die HRESULT- dieses bestimmten Fehlers.

Rückgabewert

Die Methode gibt ein HRESULT-zurück. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.

Rückgabecode	Beschreibung
S_OK	Alle Attributwerte wurden abgerufen.
S_FALSE	Mindestens ein Attributwert konnte nicht abgerufen werden. Diese enthalten HRESULT- Werte vom Typ VT_ERROR im abgerufenen ppResourceAttributes Parameter.
E_POINTER	Mindestens eines der erforderlichen Zeigerargumente war NULL-.

Bemerkungen

Ressourcenattribute beschreiben die Zugriffsrechte, Die Größe, das Format und andere Informationen im Zusammenhang mit einer Ressource. Beispielsweise können die Attribute für eine Audioanmerkungsressource für ein Bildobjekt die Bitrate, die Kanalanzahl und das Datenformat der Audiodaten angeben.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	portabledeviceapi.h
Library	PortableDeviceGUIDs.lib

Siehe auch

IPortableDeviceResources Interface

Freigeben über