IPortableDeviceCapabilities::GetFixedPropertyAttributes-Methode (portabledeviceapi.h)

Artikel
08/25/2023

Die GetFixedPropertyAttributes-Methode ruft die Standardeigenschaftsattribute für eine angegebene Eigenschaft und ein angegebenes Format ab. Standardattribute sind Solche, die denselben Wert für alle Objekte desselben Formats haben. Ein Gerät erlaubt benutzern beispielsweise möglicherweise nicht, Videodateinamen zu ändern. dieses Gerät würde WPD_PROPERTY_ATTRIBUTE_CAN_WRITE mit dem Wert False für WMV-formatierte Objekte zurückgeben. Attribute, die unterschiedliche Werte für ein Format haben können, oder optionale Attribute, werden nicht zurückgegeben.

Syntax

HRESULT GetFixedPropertyAttributes(
  [in]  REFGUID               Format,
  [in]  REFPROPERTYKEY        Key,
  [out] IPortableDeviceValues **ppAttributes
);

Parameter

[in] Format

Eine REFGUID , die das Format der relevanten Objekte angibt. Informationen zu Format-GUID-Werten finden Sie unter Objektformate.

[in] Key

Ein REFPROPERTYKEY , der die Eigenschaft angibt, deren Attribute Sie kennen möchten. Eigenschaften, die von tragbaren Windows-Geräten definiert werden, werden unter Eigenschaften und Attribute aufgeführt.

[out] ppAttributes

Adresse einer Variablen, die einen Zeiger auf eine IPortableDeviceValues-Schnittstelle empfängt , die die Attribute und deren Werte enthält. 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	Die Methode wurde erfolgreich ausgeführt.

Hinweise

Sie können WPD_OBJECT_FORMAT_ALL für den Format-Parameter angeben, um den vollständigen Satz von Eigenschaftenattributen abzurufen.

Attribute beschreiben Eigenschaften. Beispielattribute sind WPD_PROPERTY_ATTRIBUTE_CAN_READ und WPD_PROPERTY_ATTRIBUTE_CAN_WRITE. Diese Methode ruft keine Ressourcenattribute ab.

Anforderungen

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

Weitere Informationen

IPortableDeviceCapabilities-Schnittstelle

IPortableDeviceProperties::GetPropertyAttributes

Freigeben über