IWMPError.Item (VB y C#)

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

La propiedad Item (el método get_Item en C#) obtiene una interfaz IWMPErrorItem en el índice especificado de la cola de errores.

[Visual Basic]
ReadOnly Property Item(
  dwIndex As System.Integer
) As IWMPErrorItem

[C#]
IWMPErrorItem get_Item (
  System.Int32 dwIndex
);

Parámetros

dwIndex

Un system.Int32 que es el índice de base cero de una interfaz IWMPErrorItem en la cola de errores.

Valor de propiedad

Interfaz WMPLib.IWMPErrorItem .

Observaciones

Reproductor multimedia de Windows puede generar una serie de errores en respuesta a una condición de error. Esta propiedad obtiene 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 IWMPSettings.enableErrorDialogsen false si decide mostrar mensajes de error personalizados.

Ejemplos

En el ejemplo siguiente se usa la propiedad Item (el método get_Item en C#) en un controlador de eventos error para recuperar y mostrar información sobre el error más reciente en la cola de errores. El objeto AxWMPLib.AxWindowsMediaPlayer se representa mediante la variable denominada player.

private void player_ErrorEvent_get_Item(object sender, System.EventArgs e)
{
    // Store the index of the most recent error.
    int max = (player.Error.errorCount - 1);

    // Get an interface for the most recent error item. Cast it to
    // a WMPLib.IWMPErrorItem2 interface to get all of the available functionality.
    WMPLib.IWMPErrorItem2 errItem = (WMPLib.IWMPErrorItem2)player.Error.get_Item(max);

    // Use the interface to access and store the error info.
    int errNum = errItem.errorCode;
    string errDesc = errItem.errorDescription;

    // Display the error info.
    System.Windows.Forms.MessageBox.Show(errNum.ToString() + ":  " + errDesc);
}

Public Sub player_ErrorEvent_get_Item(ByVal sender As Object, ByVal e As System.EventArgs) Handles player.ErrorEvent

    ' Store the index of the most recent error.
    Dim max As Integer = (player.Error.errorCount - 1)

    ' Get an interface for the most recent error item. 
    Dim errItem As WMPLib.IWMPErrorItem2 = player.Error.Item(max)

    ' Use the interface to access and store the error info.
    Dim errNum As Integer = errItem.errorCode
    Dim errDesc As String = errItem.errorDescription

    ' Display the error info.
    System.Windows.Forms.MessageBox.Show(errNum.ToString() + ":  " + errDesc)

End Sub

Requisitos

Requisito	Value
Versión	Reproductor multimedia de Windows serie 9 o posterior
Espacio de nombres	WMPLib
Ensamblado	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Consulte también

Interfaz IWMPError (VB y C#)

Interfaz IWMPErrorItem (VB y C#)

IWMPSettings.enableErrorDialogs (VB y C#)