StringCollection.getItemInfoByType-Methode

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer ersetzt. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, nach Möglichkeit für neuen Code MediaPlayer anstelle von Windows Medienwiedergabe SDK zu verwenden. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die getItemInfoByType-Methode ruft den Wert ab, der dem angegebenen StringCollection-Index , dem angegebenen Namen, der Sprache und dem angegebenen Attributindex entspricht.

Syntax

retVal = StringCollection.getItemInfoByType(
  index,
  name,
  language,
  attributeIndex
)

Parameter

Index [in]

Zahl (long), die den nullbasierten Index des StringCollection-Elements angibt, von dem das Attribut abgerufen werden soll.

Name [in]

Zeichenfolge , die den Attributnamen enthält.

Sprache [in]

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

attributeIndex [in]

Zahl (long) mit dem nullbasierten Index des Werts, 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	Zahl (ohne Vorzeichen lang)
WM/Lyrics_Synchronised	MetadataText-Objekt
WM/Bild	MetadataPicture-Objekt
WM/UserWebURL	MetadataText-Objekt
Alle anderen Attribute	String

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

Bemerkungen

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

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

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe 11.
DLL	Wmp.dll

Siehe auch

MetadataPicture-Objekt

MetadataText-Objekt

StringCollection.getItemInfo

StringCollection-Objekt