Método Error.item

  • Artículo

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El método item recupera un objeto ErrorItem de la cola de errores.

Sintaxis

retVal = Error.item(
  index
)

Parámetros

index [in]

Número (long) que contiene el índice del objeto ErrorItem que se va a recuperar.

Valor devuelto

Este método devuelve un objeto ErrorItem .

Observaciones

Reproductor multimedia de Windows puede generar una serie de errores en respuesta a una condición de error. Este método permite la recuperación de un error específico en la cola mediante un número de índice. Los números de índice de la cola de errores comienzan por cero.

Debe establecer Configuración. enableErrorDialogs en false si decide mostrar mensajes de error personalizados.

Ejemplos

En el ejemplo siguiente de JScript se usa el error. objeto item de un controlador de eventos para alertar al usuario al error más reciente. El objeto Player se creó 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>

Requisitos

Requisito Value
Versión
 Reproductor multimedia de Windows versión 7.0 o posterior.
Archivo DLL
Wmp.dll

Consulte también

Error (objeto)

ErrorItem (objeto)