Metodo IWMPError::clearErrorQueue

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stata sostituita da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer anziché 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 clearErrorQueue cancella gli errori dalla coda di errori.

Sintassi

public void clearErrorQueue();

Public Sub clearErrorQueue()
Implements IWMPError.clearErrorQueue

Parametri

Questo metodo non presenta parametri.

Valore restituito

Questo metodo non restituisce valori.

Commenti

Usare questo metodo per cancellare la coda di errori dopo l'elaborazione di una serie di errori.

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

Esempio

Nell'esempio seguente viene usato clearErrorQueue in un gestore eventi Error per svuotare la coda di errori dopo la visualizzazione di tutte le descrizioni degli errori. L'oggetto AxWMPLib.AxWindowsMediaPlayer è rappresentato dalla variabile denominata player.

private void player_ErrorEvent_clearErrorQueue(object sender, System.EventArgs e)
{
    // Store the number of errors in the queue.
    int max = player.Error.errorCount;

    // Loop through the list of errors.
    for (int i = 0; i < max; i++)
    {
        // Get the description for this error.
        string errDesc = player.Error.get_Item(i).errorDescription;

        // Display the error message.
        System.Windows.Forms.MessageBox.Show(errDesc);
    }

    // Clear the error queue to prepare for the next group of errors.
    player.Error.clearErrorQueue();
}

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

    ' Store the number of errors in the queue.
    Dim max As Integer = player.Error.errorCount

    ' Loop through the list of errors.
    For i As Integer = 0 To (max - 1)

        ' Get the description for this error.
        Dim errDesc As String = player.Error.Item(i).errorDescription

        ' Display the error message.
        System.Windows.Forms.MessageBox.Show(errDesc)

    Next i

    ' Clear the error queue to prepare for the next group of errors.
    player.Error.clearErrorQueue()

End Sub

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows serie 9 o versioni successive
Spazio dei nomi	WMPLib
Assembly	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Vedi anche

Interfaccia IWMPError (VB e C#)

IWMPSettings.enableErrorDialogs (VB e C#)