Metodo IWMPNetwork::setProxyExceptionList

[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 setProxyExceptionList specifica l'elenco di eccezioni proxy.

Sintassi

public void setProxyExceptionList(
  System.String bstrProtocol,
  System.String pbstrExceptionList
);

Public Sub setProxyExceptionList( _
  ByVal bstrProtocol As System.String, _
  ByVal pbstrExceptionList As System.String _
)
Implements IWMPNetwork.setProxyExceptionList

Parametri

bstrProtocol [in]

Oggetto System.String che corrisponde al nome del protocollo. Per un elenco di protocolli supportati, vedere Protocolli e tipi di file supportati.

pbstrExceptionList [in]

Oggetto System.String che rappresenta un elenco delimitato da punto e virgola degli host per cui il server proxy viene ignorato. Gli spazi iniziali e finali non devono essere presenti.

Valore restituito

Questo metodo non restituisce valori.

Commenti

Si tratta di un elenco di computer, domini e/o indirizzi che ignorano il server proxy quando la parte host dell'URL di destinazione corrisponde a una voce nell'elenco.

Il carattere * può essere usato come carattere jolly per elencare le voci. Ad esempio, *.com corrisponderebbe a tutti gli host nel dominio com, mentre 67.* corrisponderebbe a tutti gli host nella subnet A della classe 67.

Questo metodo non ha alcun effetto a meno che il valore recuperato da IWMPNetwork.getProxySettings sia 2 (usare le impostazioni manuali).

Questo metodo non riesce a meno che l'applicazione chiamante non sia in esecuzione nel computer locale o nella intranet.

Esempio

Nell'esempio di codice seguente viene usato setProxyExceptionList per specificare un elenco di host per i quali il server proxy viene ignorato quando si usa il protocollo MMS. Il nuovo elenco viene recuperato da una casella di testo quando viene fatto clic su un pulsante. L'oggetto AxWMPLib.AxWindowsMediaPlayer è rappresentato dalla variabile denominata player.

private void setExList_Click(object sender, System.EventArgs e)
{
    // Test whether proxy settings are manual.
    if (player.network.getProxySettings("MMS") == 2)
    {
        // Store the user's new exception list.
        string proxyxlist = exListText.Text;

        // Set the exception list.
        player.network.setProxyExceptionList("MMS", proxyxlist);
    }
    else
    {
        // Warn that the proxy settings must be set to 2 (manual).
        System.Windows.Forms.MessageBox.Show("Proxy settings must be manual!");
    }
}

Public Sub setExList_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles setExList.Click

    ' Test whether proxy settings are manual.
    If (player.network.getProxySettings("MMS") = 2) Then

        ' Store the user's new exception list.
        Dim proxyxlist As String = exListText.Text

        ' Set the exception list.
        player.network.setProxyExceptionList("MMS", proxyxlist)

    Else

        ' Warn that the proxy settings must be set to 2 (manual).
        System.Windows.Forms.MessageBox.Show("Proxy settings must be manual!")

    End If

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 IWMPNetwork (VB e C#)

IWMPNetwork.getProxyExceptionList (VB e C#)

IWMPNetwork.getProxySettings (VB e C#)