IPortableDeviceCapabilities::GetSupportedFormatProperties-Methode (portabledeviceapi.h)
Die GetSupportedFormatProperties-Methode ruft die Eigenschaften ab, die von Objekten eines angegebenen Formats auf dem Gerät unterstützt werden.
Syntax
HRESULT GetSupportedFormatProperties(
[in] REFGUID Format,
[out] IPortableDeviceKeyCollection **ppKeys
);
Parameter
[in] Format
Eine REFGUID , die das Format des Objekts angibt. Eine Liste der Formate, die von tragbaren Windows-Geräten definiert werden, finden Sie unter Objektformate.
[out] ppKeys
Adresse einer Variablen, die einen Zeiger auf eine IPortableDeviceKeyCollection-Schnittstelle empfängt, die die unterstützten Eigenschaften für das angegebene Format enthält. Eine Liste der eigenschaften, die von tragbaren Windows-Geräten definiert werden, finden Sie unter Eigenschaften und Attribute. 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 |
|---|---|
|
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.
Wenn einem Objekt kein Wert zugewiesen ist, oder wenn die Eigenschaft gelöscht wurde, meldet ein Gerät die Eigenschaft möglicherweise überhaupt nicht, wenn es seine Eigenschaften aufzählt. Möglicherweise meldet ein anderes Gerät die Eigenschaft, jedoch mit einer leeren Zeichenfolge oder einem Wert von 0 . Um diese Inkonsistenz zu vermeiden, können Sie diese Methode aufrufen, um alle Eigenschaften zu lernen, die Sie für ein bestimmtes Objekt festlegen können.
Requirements (Anforderungen)
| Zielplattform | Windows |
| Kopfzeile | portabledeviceapi.h |
| Bibliothek | PortableDeviceGUIDs.lib |