Freigeben über


IPortableDeviceProperties::GetPropertyAttributes-Methode (portabledeviceapi.h)

Die GetPropertyAttributes-Methode ruft Attribute einer angegebenen Objekteigenschaft auf einem Gerät ab.

Syntax

HRESULT GetPropertyAttributes(
  [in]  LPCWSTR               pszObjectID,
  [in]  REFPROPERTYKEY        Key,
  [out] IPortableDeviceValues **ppAttributes
);

Parameter

[in] pszObjectID

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

[in] Key

Ein REFPROPERTYKEY , der die abzufragende Eigenschaft angibt. Sie können eine Liste der unterstützten Eigenschaften abrufen, indem Sie GetSupportedProperties aufrufen. Eine Liste der Eigenschaften, die von tragbaren Windows-Geräten definiert werden, finden Sie unter Eigenschaften und Attribute.

[out] ppAttributes

Adresse einer Variablen, die einen Zeiger auf eine IPortableDeviceValues-Schnittstelle empfängt , die die abgerufenen Eigenschaftsattribute enthält. Hierbei handelt es sich um PROPERTYKEY-Wert-Paare, wobei PROPERTYKEY die Eigenschaft ist und der Wertdatentyp von der jeweiligen Eigenschaft abhängt. Der Aufrufer muss diese Schnittstelle freigeben, wenn sie damit fertig ist. Attribute, die von tragbaren Windows-Geräten definiert werden, finden Sie auf der Seite Eigenschaften und Attribute .

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 war erfolgreich, und alle Attribute wurden erfolgreich abgerufen.
S_FALSE
Es konnten nur einige Attributwerte abgerufen werden. Andere konnten nicht und enthalten einen HRESULT-Wert vom Typ VT_ERROR.
E_POINTER
Ein erforderliches Zeigerargument war NULL.

Hinweise

Eigenschaftenattribute beschreiben die Zugriffsrechte, gültigen Werte und andere Informationen einer Eigenschaft. Beispielsweise kann für eine Eigenschaft ein WPD_PROPERTY_ATTRIBUTE_CAN_DELETE Wert auf False festgelegt sein, um das Löschen zu verhindern, und es kann ein Bereich gültiger Werte als einzelne Einträge gespeichert werden.

Beispiele

Ein Beispiel für die Verwendung dieser Methode finden Sie unter Festlegen von Eigenschaften für ein einzelnes Objekt.

Anforderungen

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

Weitere Informationen

IPortableDeviceProperties-Schnittstelle

Festlegen von Eigenschaften für ein einzelnes Objekt

Schreiben von Content-Object-Eigenschaften