Fehlerbehandlung (Windows Medienwiedergabe SDK)

Das Windows Medienwiedergabe 6.4-ActiveX-Steuerelement bietet standardmäßige Fehlerbehandlung, indem Fehlermeldungen in Dialogfeldern und auf der Statusleiste angezeigt werden. Sie können auch benutzerdefinierte Fehlerbehandlung bereitstellen, indem Sie Fehler in Ihrem Skript verarbeiten. Die Fehlerbehandlung ist ereignisgesteuert, was bedeutet, dass Sie eine Benachrichtigung für jeden Fehler erhalten und entscheiden müssen, wie Sie mit jedem Fehlerereignis umgehen können, wenn es auftritt. Weitere Informationen zum Behandeln von Fehlern mithilfe des Version 6.4-Objektmodells finden Sie im Abschnitt "Fehlerbehandlung" des Version 6.4 Player-Objektmodellhandbuchs, das Teil des Windows Medienwiedergabe SDK ist.

Das Windows Medienwiedergabe 7 oder höher-Objektmodell stellt das Error-Objekt und das ErrorItem-Objekt bereit, um Fehler zu behandeln. Diese beiden Objekte arbeiten zusammen, um Ihnen einen Fehlerbehandlungsmechanismus bereitzustellen, der Ihnen die vollständige und flexible Kontrolle des Fehlerbehandlungsprozesses ermöglicht. Das Error-Objekt bietet Zugriff auf eine Auflistung von ErrorItem-Objekten ; Jedes ErrorItem-Objekt enthält Details zu einer einzelnen Fehlermeldung.

Wenn ein Fehler auftritt, werden die Fehlerinformationen in eine Fehlerwarteschlange gepostet. Die Warteschlange ist eine Auflistung von ErrorItem-Objekten . Da jeder Fehler der Warteschlange hinzugefügt wird, wird es einer Indexnummer (beginnend mit Null) zugeordnet, die verwendet werden kann, um das bestimmte ErrorItem-Objekt zu identifizieren. Der Fehler. errorCount-Eigenschaft ruft die Anzahl der Fehler in der Fehlerwarteschlange ab. Da die Indexnummern nullbasiert sind, hat der neueste Fehler, der in die Warteschlange gepostet wurde, immer einen Indexwert gleich "Fehler". errorCount minus 1.

Sie können einen Fehlerereignishandler für Windows Medienwiedergabe mithilfe von Skript erstellen. Im folgenden JScript Beispiel wird gezeigt, wie Sie das neueste Fehlerelement aus der Fehlerwarteschlange abrufen und den Fehlercode und die Fehlerbeschreibung mithilfe des Windows Medienwiedergabe 7 oder höher-Objektmodells anzeigen. Das Player-Objekt wurde mit ID = "WMP9" erstellt.

<!-- Create an error event handler for Windows Media Player 7 or later errors. -->
<SCRIPT  LANGUAGE = "JScript"  FOR = WMP9  EVENT = error()>

// Store the number of errors in the error queue.
var max = WMP9.error.errorCount;

// Retrieve most recent ErrorItem object.
var err = WMP9.error.item(max-1)

// Store the error code number.
var errNum = err.errorCode;

// Store the error description string.
var errDesc = err.errorDescription;

// Build a message string to notify the user.
var msg = "Error number: " + errNum + "\n";
msg += "Error description: " + errDesc;

// Display the message box.
alert(msg);

</SCRIPT>

Das Error-Objekt verfügt über zwei zusätzliche Methoden, die Sie verwenden können. Der Fehler. mit der ClearErrorQueue-Methode können Sie alle Fehler aus der Fehlerwarteschlange entfernen und die Indexnummer auf Null zurücksetzen. Sie haben die vollständige Kontrolle über diesen Prozess; Sie können Fehler in der Warteschlange so lange beibehalten, wie sie verfügbar sein müssen, und leeren Sie dann die Warteschlange, wenn Sie die Fehler verarbeitet haben.

Der Fehler. WebHelp-Methode bietet eine Möglichkeit, die aktuellen Fehlerinformationen für den Benutzer mithilfe des Internets anzuzeigen. Bei Aufruf übertragen diese Methode alle relevanten Informationen über den ersten Fehler in der Warteschlange (die mit Index null) an Microsoft Windows Medienwiedergabe Webhilfe, die weitere Informationen zum Fehler im aktuellen Browserfenster anzeigt.

Error-Objekt

ErrorItem-Objekt

Objektmodellmigrationshandbuch