Error.item-Methode

  • Artikel

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

Die item-Methode ruft ein ErrorItem-Objekt aus der Fehlerwarteschlange ab.

Syntax

retVal = Error.item(
  index
)

Parameter

Index [in]

Number (long) mit dem Index des abzurufenden ErrorItem-Objekts .

Rückgabewert

Diese Methode gibt ein ErrorItem-Objekt zurück.

Hinweise

Windows Medienwiedergabe können als Reaktion auf eine Fehlerbedingung eine Reihe von Fehlern generieren. Diese Methode ermöglicht das Abrufen eines bestimmten Fehlers in der Warteschlange mithilfe einer Indexnummer. Die Indexnummern für die Fehlerwarteschlange beginnen mit null.

Sie sollten Einstellungen festlegen. enableErrorDialogs auf false, wenn Sie benutzerdefinierte Fehlermeldungen anzeigen möchten.

Beispiele

Im folgenden JScript-Beispiel wird der Fehler verwendet. item-Objekt in einem Ereignishandler, um den Benutzer auf den letzten Fehler zu warnen. Das Player-Objekt wurde mit der ID = "Player" erstellt.

<SCRIPT LANGUAGE="JScript"  FOR=Player EVENT=error()>

// Store the most recent error item number.
var max = Player.error.errorCount - 1 

// Store the most recent error in an error item object.
var errItem = Player.error.item(max);

// Use the error item object to store the error info.
errDesc = errItem.errorDescription;
errNum = errItem.errorCode;

// Display the error info.
alert(errNum + "\n" + errDesc);

</SCRIPT>

Anforderungen

Anforderung Wert
Version
 Windows Medienwiedergabe Version 7.0 oder höher.
DLL
Wmp.dll

Siehe auch

Error-Objekt

ErrorItem-Objekt