Media.getItemInfoByType-Methode

Die getItemInfoByType-Methode ruft den Wert des Attributs ab, das dem angegebenen Attributnamen, der angegebenen Sprache und dem angegebenen Index entspricht.

Syntax

retVal = Media.getItemInfoByType(
  name,
  language,
  index
)

Parameter

name [ In]

Zeichenfolge, die den Namen des Attributs enthält. Informationen zu den attributen, die von Windows Media Player unterstützt werden, finden Sie unter Windows Media Player Attributreferenz.

Language (Sprache) [ In]

Zeichenfolge, die die Sprache darstellt. Wenn der Wert auf NULL oder "" (leere Zeichenfolge) festgelegt ist, wird die aktuelle Gebietsschemazeichenfolge verwendet. Andernfalls muss der Wert eine gültige RFC 1766-Sprachzeichenfolge wie "en-us" sein.

Index [ In]

Number (long), die den nullbasierten Index des Werts enthält, der aus dem Attribut abgerufen werden soll.

Rückgabewert

Diese Methode gibt ein Number-, String-, MetadataPicture- oder MetadataText-Objekt zurück, wie in der folgenden Tabelle angegeben.

attribute Rückgabewert
SyncState Number (unsigned long)
WM/Synchronisierte Wm/Wm-Synchronisierung _ MetadataText-Objekt
WM/Bild MetadataPicture-Objekt
WM/UserWebURL MetadataText-Objekt
Alle anderen Attribute String

Für Attribute, deren zugrunde liegender Wert boolesch ist, gibt diese Methode die Zeichenfolge "true" oder "false" zurück.

Hinweise

Diese Methode ruft die Metadaten für ein einzelnes digitales Medienelement oder ein Medienelement ab, das Teil einer Wiedergabeliste ist.

Diese Methode unterstützt Attribute mit mehreren Werten und Attribute mit komplexen Werten. Die getItemInfo-Methode unterstützt keine Attribute mit mehreren Werten und Attribute mit komplexen Werten.

Die attributeCount-Eigenschaft enthält die Anzahl der Attributnamen, die für ein bestimmtes Media-Objekt verfügbar sind. Indexnummern können dann mit der getAttributeName-Methode verwendet werden, um den Namen jedes verfügbaren Attributs zu bestimmen. Einzelne Attributnamen können an den name-Parameter von getItemInfoByType übergeben werden.

Die getAttributeCountByType-Methode gibt die Anzahl der Attribute zurück, die einem bestimmten Attributnamen für ein bestimmtes Media-Objekt entsprechen. Indexnummern können dann an den Indexparameter von getItemInfoByType übergeben werden. Dies ist beispielsweise nützlich, wenn ein digitales Medienelement unter mehreren Medien kategorisiert wurde.

Um diese Methode zu verwenden, ist Lesezugriff auf die Bibliothek erforderlich. Weitere Informationen finden Sie unter Bibliothekszugriff.

Diese Methode kann Fehler verursachen. Sie sollten beim Aufrufen dieser Methode Fehlerbehandlungscode einschließen. In JScript können Sie z. B. die Fehlerbehandlung mithilfe von try... implementieren. Fangen... finally-Struktur.

Windows Media Player 10 Mobile: Diese Methode wird nicht unterstützt.

Anforderungen

Anforderung Wert
Version
Windows Media Player serie 9 oder höher.
DLL
Wmp.dll

Weitere Informationen

Medienobjekt

Media.attributeCount

Media.getAttributeCountByType

Media.getAttributeName

Media.getItemInfo

Media.setItemInfo

MetadataPicture-Objekt

MetadataText-Objekt

Lesen von Attributwerten

Einstellungen.mediaAccessRights

Einstellungen.requestMediaAccessRights