Método IWMPNetwork::setProxySettings

[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 setProxySettings especifica la configuración de proxy de un protocolo.

Sintaxis

public void setProxySettings(
  System.String bstrProtocol,
  System.Int32 lProxySetting
);

Public Sub setProxySettings( _
  ByVal bstrProtocol As System.String, _
  ByVal lProxySetting As System.Int32 _
)
Implements IWMPNetwork.setProxySettings

Parámetros

bstrProtocol [in]

System.String que es el nombre del protocolo. Para obtener una lista de los protocolos admitidos, consulte Protocolos admitidos y tipos de archivo.

lProxySetting [in]

System.Int32 que es uno de los valores siguientes.

Value Descripción
0 No usar ningún servidor proxy.
1 Use la configuración de proxy del explorador actual (válida solo para HTTP).
2 Use la configuración de proxy especificada manualmente.
3 Detectar automáticamente la configuración del proxy.

Valor devuelto

Este método no devuelve ningún valor.

Observaciones

Este método produce un error a menos que la aplicación que realiza la llamada se ejecute en el equipo local o en la intranet.

Ejemplos

En el ejemplo de código siguiente se usa un cuadro de lista para permitir al usuario establecer la configuración de proxy de Reproductor multimedia de Windows para el protocolo HTTP. El objeto AxWMPLib.AxWindowsMediaPlayer se representa mediante la variable denominada player.

// Load the list box with the proxy settings in order so that their index in the
// list box matches their value.
proxySettings.Items.Add("Do not use a proxy server.  (Value = 0)");                                             
proxySettings.Items.Add("Use the proxy settings of the current browser. Valid for HTTP only.  (Value = 1)");
proxySettings.Items.Add("Use the manually specified proxy settings.  (Value = 2)");
proxySettings.Items.Add("Auto-detect the proxy settings.  (Value = 3)");                                       

// Change the proxy setting for the HTTP protocol when the user makes a list box selection.
private void proxySettings_OnSelectedIndexChanged(object sender, System.EventArgs e)
{
    // Store the index of the setting from the ListBox
    int setting = ((System.Windows.Forms.ListBox)sender).SelectedIndex;

    // Change the proxy setting. 
    player.network.setProxySettings("HTTP", setting);
}

' Load the list box with the proxy settings in order so that their index in the
' list box matches their value.
proxySettings.Items.Add("Do not use a proxy server.  (Value = 0)")
proxySettings.Items.Add("Use the proxy settings of the current browser. Valid for HTTP only.  (Value = 1)")
proxySettings.Items.Add("Use the manually specified proxy settings.  (Value = 2)")
proxySettings.Items.Add("Auto-detect the proxy settings.  (Value = 3)")

' Change the proxy setting for the HTTP protocol when the user makes a list box selection.
Public Sub proxySettings_OnSelectedIndexChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles proxySettings.SelectedIndexChanged

    ' Store the index of the setting from the ListBox
    Dim lb As System.Windows.Forms.ListBox = sender
    Dim setting As Integer = lb.SelectedIndex

    ' Change the proxy setting. 
    player.network.setProxySettings("HTTP", setting)
    
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 IWMPNetwork (VB y C#)

IWMPNetwork.getProxySettings (VB y C#)