Fehlerbehandlung (Windows Medienwiedergabe SDK)

  • 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.]

Das ActiveX-Steuerelement Windows Medienwiedergabe 6.4 bietet standardmäßige Fehlerbehandlung, indem Fehlermeldungen in Dialogfeldern und auf der status leiste angezeigt werden. Sie können auch eine benutzerdefinierte Fehlerbehandlung bereitstellen, indem Sie Fehler in Ihrem Skript verarbeiten. Die Fehlerbehandlung erfolgt ereignisgesteuert. Dies bedeutet, dass Sie für jeden Fehler eine Benachrichtigung erhalten und entscheiden müssen, wie mit jedem Fehlerereignis umgegangen werden soll, wenn es auftritt. Weitere Informationen zur Behandlung von Fehlern mit dem Objektmodell der Version 6.4 finden Sie im Abschnitt Fehlerbehandlung des Player-Objektmodellhandbuchs der Version 6.4, das Teil des Windows Medienwiedergabe SDK ist.

Das objektmodell Windows Medienwiedergabe 7 oder höher stellt das Error-Objekt und das ErrorItem-Objekt zur Behandlung von Fehlern bereit. Diese beiden Objekte arbeiten zusammen, um Ihnen einen Fehlerbehandlungsmechanismus bereitzustellen, der Ihnen eine vollständige und flexible Kontrolle über den Fehlerbehandlungsprozess bietet. 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 an eine Fehlerwarteschlange gesendet. Die Warteschlange ist eine Sammlung von ErrorItem-Objekten . Da jeder Fehler der Warteschlange hinzugefügt wird, wird er einer Indexnummer (beginnend mit 0) zugeordnet, die zum Identifizieren des bestimmten ErrorItem-Objekts verwendet werden kann. Der Fehler. Die errorCount-Eigenschaft ruft die Anzahl der Fehler in der Fehlerwarteschlange ab. Da die Indexnummern nullbasiert sind, weist der letzte in der Warteschlange gesendete Fehler immer einen Indexwert auf, der gleich Fehler ist. errorCount minus 1.

Sie können mithilfe eines Skripts einen Fehlerereignishandler für Windows Medienwiedergabe erstellen. Das folgende JScript-Beispiel zeigt, wie Sie das letzte Fehlerelement aus der Fehlerwarteschlange abrufen und den Fehlercode und die Fehlerbeschreibung mithilfe des objektmodells Windows Medienwiedergabe 7 oder höher anzeigen. Das Player-Objekt wurde mit der 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 so lange in der Warteschlange aufbewahren, wie Sie sie benötigen, um verfügbar zu sein, und dann die Warteschlange leeren, wenn Sie die Behandlung der Fehler abgeschlossen haben.

Der Fehler. Die webHelp-Methode bietet eine Möglichkeit zum Anzeigen der aktuellsten Fehlerinformationen für den Benutzer mithilfe des Internets. Wenn diese Methode aufgerufen wird, überträgt diese Methode alle relevanten Informationen zum ersten Fehler in der Warteschlange (der mit Index null) an die Microsoft Windows Medienwiedergabe-Webhilfe, die weitere Informationen zum Fehler im aktuellen Browserfenster anzeigt.

Error-Objekt

ErrorItem-Objekt

Leitfaden zur Objektmodellmigration