Metodo Error.item

  • Articolo

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stato sostituito da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer invece di Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il metodo item recupera un oggetto ErrorItem dalla coda degli errori.

Sintassi

retVal = Error.item(
  index
)

Parametri

index [in]

Numero (long) contenente l'indice dell'oggetto ErrorItem da recuperare.

Valore restituito

Questo metodo restituisce un oggetto ErrorItem .

Commenti

Lettore multimediale Windows può generare un numero di errori in risposta a una condizione di errore. Questo metodo consente il recupero di un errore specifico nella coda usando un numero di indice. I numeri di indice per la coda degli errori iniziano con zero.

È consigliabile impostare Impostazioni. enableErrorDialogs su false se si sceglie di visualizzare messaggi di errore personalizzati.

Esempio

Nell'esempio JScript seguente viene usato l'errore . oggetto item in un gestore eventi per avvisare l'utente dell'errore più recente. L'oggetto Player è stato creato con 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>

Requisiti

Requisito Valore
Versione
 Lettore multimediale Windows versione 7.0 o successiva.
DLL
Wmp.dll

Vedi anche

Oggetto Error

Oggetto ErrorItem