Método IWMPNetwork::getProxySettings

[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 getProxySettings devuelve información sobre la configuración de proxy de un protocolo.

Sintaxis

public System.Int32 getProxySettings(
  System.String bstrProtocol
);

Public Function getProxySettings( _
  ByVal bstrProtocol As System.String _
) As System.Int32
Implements IWMPNetwork.getProxySettings

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.

Valor devuelto

System.Int32 que es uno de los valores siguientes.

Value	Descripción
0	No se está usando un servidor proxy.
1	La configuración de proxy para el explorador actual se usa (solo es válida para HTTP).
2	Se usa la configuración de proxy especificada manualmente.
3	La configuración del proxy se detecta automáticamente.

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 getProxySettings para mostrar un mensaje, que proporciona información sobre la configuración de proxy actual del Reproductor, en una etiqueta. El objeto AxWMPLib.AxWindowsMediaPlayer se representa mediante la variable denominada player.

// Retrieve a number representing the current proxy settings.
int proxySetting = player.network.getProxySettings("MMS");

// Display the message that corresponds to the current settings.
switch(proxySetting)
{
    case 0:
    proxySettingsLabel.Text = "A proxy server is not being used";
    break;

    case 1: 
    proxySettingsLabel.Text = "The proxy settings for the current browser are being used.";
    break;

    case 2:
    proxySettingsLabel.Text = "The manually specified proxy settings are being used.";
    break;

    case 3:
    proxySettingsLabel.Text = "The proxy settings are being auto-detected.";
    break;

    default:
    proxySettingsLabel.Text = "Unable to determine proxy setting, try again.";
    break;
}

' Retrieve a number representing the current proxy settings.
Dim proxySetting As Integer = player.network.getProxySettings("MMS")

' Display the message that corresponds to the current settings.
Select Case proxySetting

    Case 0
        proxySettingsLabel.Text = "A proxy server is not being used"

    Case 1
        proxySettingsLabel.Text = "The proxy settings for the current browser are being used."

    Case 2
        proxySettingsLabel.Text = "The manually specified proxy settings are being used."

    Case 3
        proxySettingsLabel.Text = "The proxy settings are being auto-detected."

    Case Else
        proxySettingsLabel.Text = "Unable to determine proxy setting, try again."

End Select

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.setProxySettings (VB y C#)