IPortableDeviceProperties::GetPropertyAttributes-Methode (portabledeviceapi.h)

Artikel
08/25/2023

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.