Gestion des erreurs (sdk Lecteur multimédia Windows)

Le contrôle Lecteur multimédia Windows 6.4 ActiveX fournit la gestion des erreurs par défaut en affichant les messages d’erreur dans les boîtes de dialogue et dans la barre d’état. Vous pouvez également fournir une gestion personnalisée des erreurs en traitant les erreurs dans votre script. La gestion des erreurs est pilotée par les événements, ce qui signifie que vous recevez une notification pour chaque erreur et que vous devez décider comment gérer chaque événement d’erreur lorsqu’il se produit. Pour plus d’informations sur la gestion des erreurs à l’aide du modèle objet version 6.4, consultez la section Gestion des erreurs du Guide du modèle objet du lecteur version 6.4, qui fait partie du Kit de développement logiciel (SDK) Lecteur multimédia Windows.

Le modèle objet Lecteur multimédia Windows 7 ou version ultérieure fournit l’objet Error et l’objet ErrorItem pour gérer les erreurs. Ces deux objets fonctionnent ensemble pour vous fournir un mécanisme de gestion des erreurs qui vous donne un contrôle complet et flexible du processus de gestion des erreurs. L’objet Error fournit l’accès à une collection d’objets ErrorItem ; chaque objet ErrorItem fournit des détails sur un message d’erreur individuel.

Lorsqu’une erreur se produit, les informations d’erreur sont publiées dans une file d’attente d’erreurs. La file d’attente est une collection d’objets ErrorItem . À mesure que chaque erreur est ajoutée à la file d’attente, elle est associée à un numéro d’index (commençant par zéro) qui peut être utilisé pour identifier l’objet ErrorItem particulier. Erreur. la propriété errorCount récupère le nombre d’erreurs dans la file d’attente d’erreurs. Étant donné que les numéros d’index sont de base zéro, l’erreur la plus récente publiée dans la file d’attente aura toujours une valeur d’index égale à Error. errorCount moins un.

Vous pouvez créer un gestionnaire d’événements d’erreur pour Lecteur multimédia Windows à l’aide d’un script. L’exemple JScript suivant montre comment récupérer l’élément d’erreur le plus récent de la file d’attente d’erreurs et afficher le code d’erreur et la description de l’erreur à l’aide du modèle objet Lecteur multimédia Windows 7 ou ultérieur. L’objet Player a été créé avec l’ID = « WMP9 ».

<!-- 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>

L’objet Error a deux méthodes supplémentaires que vous pouvez utiliser. Erreur. La méthode clearErrorQueue vous permet de supprimer toutes les erreurs de la file d’attente d’erreurs et de réinitialiser le numéro d’index à zéro. Vous avez un contrôle total sur ce processus; vous pouvez conserver les erreurs dans la file d’attente tant que vous en avez besoin pour être disponibles, puis vider la file d’attente lorsque vous avez fini de gérer les erreurs.

Erreur. La méthode webHelp permet d’afficher les informations d’erreur les plus actuelles à l’utilisateur à l’aide d’Internet. Lorsqu’elle est appelée, cette méthode transfère toutes les informations pertinentes sur la première erreur dans la file d’attente (celle avec index zéro) à Microsoft Lecteur multimédia Windows l’aide web, qui affiche des informations supplémentaires sur l’erreur dans la fenêtre de navigateur active.

Error, objet

ErrorItem, objet

Guide de migration du modèle objet