Freigeben über


Objekteigenschaften

Windows Portable Devices unterstützt die folgenden Objekteigenschaften.

Eigenschaft VarType Beschreibung
WPD_OBJECT_BACK_REFERENCES VT_UNKNOWN Eine IPortableDevicePropVariantCollection vom Typ VT_LPWSTR eine Liste von ObjectIDs angibt. Wenn ein Containerobjekt auf ein Objekt verweist, z. B. ein Audioobjekt, auf das von einer Wiedergabeliste verwiesen wird, verwendet das Objekt, auf das verwiesen wird, diese Eigenschaft, um auf sein Containerobjekt zurück zu verweisen. Das Audioobjekt kann auf das Wiedergabelistenobjekt in diesem Beispiel verweisen.
WPD_OBJECT_CAN_DELETE VT_BOOL Ein boolescher Wert, der angibt, ob das angegebene Objekt gelöscht werden kann.
WPD_OBJECT_CONTAINER_FUNCTIONAL_OBJECT_ID VT_LPWSTR Die Objekt-ID des nächstgelegenen Funktionsobjekts, das dieses Objekt enthält. Für eine Datei in einem Speicherfunktionsobjekt ist diese Eigenschaft beispielsweise auf die ID des Speicherfunktionsobjekts festgelegt.
WPD_OBJECT_CONTENT_TYPE VT_CLSID Eine GUID , die den generischen Typ dieses Objekts identifiziert, z. B. ein Dokument oder eine E-Mail. Dies kann ein objekttyp sein, der von tragbaren Windows-Geräten definiert wird, oder ein benutzerdefinierter Treiberinhaltstyp. Das Geräteobjekt ist das einzige Objekt, das diese Eigenschaft nicht meldet.
WPD_OBJECT_DATE_AUTHORED VT_DATE Ein Wert, der das Datum und die Uhrzeit der Erstellung des Inhalts angibt. Dies ist möglicherweise nicht mit dem Erstellungsdatum der Datei identisch. Beispielsweise weist eine Musikdatei ein Erstellungsdatum auf, an dem die Musik aufgezeichnet wurde, aber ein Erstellungsdatum des Zeitpunkts, an dem die WMA-Datei tatsächlich auf dem Gerät erstellt wurde.
WPD_OBJECT_DATE_CREATED VT_DATE Ein Wert, der das Datum und die Uhrzeit der Erstellung des Objekts auf dem Gerät angibt.
WPD_OBJECT_DATE_MODIFIED VT_DATE Ein Wert, der das Datum und die Uhrzeit der Änderung des Objekts auf dem Gerät angibt.
WPD_OBJECT_FORMAT VT_CLSID Eine GUID , die das Format der Objektdaten identifiziert. Dies kann ein format sein, das von tragbaren Windows-Geräten oder ein benutzerdefiniertes Treiberformat definiert wird.
WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE VT_BOOL Ein boolescher Wert, der angibt, ob das Miniaturbild für dieses Objekt aus den Standardressourcendaten erstellt werden soll. Dies bietet eine Möglichkeit für Objekte ohne Miniaturansichtsressource, eine benutzerfreundlichere Browserumgebung zu bieten. Die Verwendung dieses Flags kann sich auf die erste Anzeigeantwort auswirken, da die Anwendung ein Miniaturbild vom Gerät abrufen und berechnen muss. es ist effizienter, wenn möglich eine separate Miniaturansichts-Bildressource bereitzustellen.
WPD_OBJECT_HINT_LOCATION_DISPLAY_NAME VT_LPWSTR Wenn das angegebene Objekt als Hinweisspeicherort angezeigt wird, gibt diese Eigenschaft den hinweisspezifischen Namen an, der anstelle des Objektnamens angezeigt werden soll. Treiber können Standorthinweise für verschiedene Inhaltstypen angeben. Diese können als Verknüpfungen zu Ordnerobjekten der obersten Ebene betrachtet werden, die Objekte der angegebenen Typen enthalten. Clients, die diese Speicherorthinweise verwenden, können einen Namen für diese Verknüpfungen anzeigen, der sich vom Objektnamen des Ordners unterscheidet. Wenn diese Eigenschaft nicht vorhanden ist, wird in der Regel stattdessen die WPD_OBJECT_NAME verwendet.
WPD_OBJECT_ID VT_LPWSTR Eine Zeichenfolgen-ID, die das Objekt auf dem Gerät eindeutig identifiziert. Diese ID muss nicht sitzungsübergreifend gespeichert werden. Wenn diese Eigenschaft sowohl eindeutig als auch dauerhaft ist, kann der Treiber sowohl WPD_OBJECT_PERSISTENT_UNIQUE_ID als auch WPD_OBJECT_ID auf denselben Wert festlegen.
WPD_OBJECT_IS_DRM_PROTECTED VT_BOOL Ein boolescher Wert, der angibt, ob die Mediendaten DRM-geschützt sind. Wenn nicht vorhanden, wird davon ausgegangen, dass dies False ist.
WPD_OBJECT_ISHIDDEN VT_BOOL Ein boolescher Wert, der angibt, ob das Objekt ausgeblendet werden soll. Wenn es nicht vorhanden ist, wird davon ausgegangen, dass das Objekt nicht ausgeblendet ist.
WPD_OBJECT_CAN_DELETE VT_BOOL Ein boolescher Wert, der angibt, ob das Objekt gelöscht werden kann.
WPD_OBJECT_ISSYSTEM VT_BOOL Ein boolescher Wert, der angibt, ob das Objekt Systemdaten (z. B. eine Systemdatei) darstellt. Wenn es sich nicht um ein Systemobjekt handelt, wird davon ausgegangen, dass es sich bei dem Objekt nicht um ein Systemobjekt handelt.
WPD_OBJECT_KEYWORDS VT_LPWSTR Zeichenfolge mit einer Liste mit leerzeichentrennten Schlüsselwörtern, die diesem Objekt zugeordnet sind.
WPD_OBJECT_LANGUAGE_LOCALE VT_LPWSTR Eine Zeichenfolge, die die von einem bestimmten Objekt verwendete Sprache demotiviert. Wenn in diesem Objekt mehrere Sprachen enthalten sind, sollte die primäre Sprache identifiziert werden. Diese Eigenschaft kann entweder einen Sprachcode enthalten, wie in ISO-639 definiert, z. B. "en". Es kann auch einen Sprach-Ländercode enthalten, der aus einem Sprachcode mit zwei oder drei Zeichen besteht, wie in der ISO-639-Norm definiert, gefolgt von einem Bindestrich, gefolgt von einem Ländercode gemäß ISO-3166, z. B. "en-US".
WPD_OBJECT_NAME VT_LPWSTR Der Anzeigename für das Objekt.
WPD_OBJECT_NON_CONSUMABLE VT_BOOL Ein boolescher Wert, der angibt, ob dieses Objekt vom Gerät verstanden oder nur gespeichert werden soll. Wenn diese Eigenschaft nicht vorhanden ist, wird davon ausgegangen, dass alle Daten für den Verbrauch bestimmt sind.
WPD_OBJECT_ORIGINAL_FILE_NAME VT_LPWSTR Ein Zeichenfolgenname für die Datei.
WPD_OBJECT_PARENT_ID VT_LPWSTR Die Objekt-ID des übergeordneten Objekts. Das einzige Objekt, das eine leere Zeichenfolge für diesen Wert zurückgeben kann, ist das Stammgerätobjekt. Um diese Eigenschaft zu ändern, rufen Sie IPortableDevice::SendCommand (WPD_COMMAND_STORAGE_MOVE) auf.
WPD_OBJECT_PERSISTENT_UNIQUE_ID VT_LPWSTR Eine Zeichenfolgen-ID, die das Objekt auf dem Gerät eindeutig identifiziert, ähnlich wie WPD_OBJECT_ID, aber es muss sitzungsübergreifend gespeichert werden. Wenn der Objektbezeichner WPD_OBJECT_ID sowohl eindeutig als auch dauerhaft ist, kann der Treiber sowohl WPD_OBJECT_PERSISTENT_UNIQUE_ID als auch WPD_OBJECT_ID auf denselben Wert festlegen.
WPD_OBJECT_REFERENCES VT_UNKNOWN Eine IPortableDevicePropVariantCollection , die eine Auflistung von VT_LPWSTR Objekt-IDs enthält, die die Objekte identifizieren, auf die verwiesen wird. Dies ist nur erforderlich, wenn es sich bei dem Objekt um ein Verweisobjekt handelt, z. B. ein Ordner oder eine Wiedergabeliste.
WPD_OBJECT_SIZE VT_UI8 Die Größe der Objektressourcendaten.
WPD_OBJECT_SYNC_ID VT_LPWSTR Eine undurchsichtige Zeichenfolge, die von einem Client erstellt wurde, um den Zustand zwischen Sitzungen beizubehalten, ohne einen Katalog verbundener Geräteinhalte beizubehalten.

Anforderungen

Anforderung Wert
Header
PortableDevice.h

Siehe auch

WPD-Eigenschaften und -Attribute