Error.item, méthode

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La méthode item récupère un objet ErrorItem de la file d’attente d’erreurs.

Syntaxe

retVal = Error.item(
  index
)

Paramètres

index [in]

Numéro (long) contenant l’index de l’objet ErrorItem à récupérer.

Valeur retournée

Cette méthode retourne un objet ErrorItem .

Notes

Lecteur multimédia Windows pouvez générer un certain nombre d’erreurs en réponse à une condition d’erreur. Cette méthode permet la récupération d’une erreur spécifique dans la file d’attente à l’aide d’un numéro d’index. Les numéros d’index de la file d’attente d’erreurs commencent par zéro.

Vous devez définir paramètres. activezErrorDialogs sur false si vous choisissez d’afficher des messages d’erreur personnalisés.

Exemples

L’exemple JScript suivant utilise l’erreur. objet item dans un gestionnaire d’événements pour avertir l’utilisateur de l’erreur la plus récente. L’objet Player a été créé avec l’ID = « Player ».

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

Configuration requise

Condition requise	Valeur
Version	Lecteur multimédia Windows version 7.0 ou ultérieure.
DLL	Wmp.dll

Voir aussi

Error, objet

Objet ErrorItem