IWMPNetwork::getProxySettings method
[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The getProxySettings method returns information about the proxy settings for a protocol.
Syntax
public System.Int32 getProxySettings(
System.String bstrProtocol
);
Public Function getProxySettings( _
ByVal bstrProtocol As System.String _
) As System.Int32
Implements IWMPNetwork.getProxySettings
Parameters
-
bstrProtocol [in]
-
A System.String that is the protocol name. For a list of supported protocols, see Supported Protocols and File Types.
Return value
A System.Int32 that is one of the following values.
| Value | Description |
|---|---|
| 0 | A proxy server is not being used. |
| 1 | The proxy settings for the current browser are being used (valid only for HTTP). |
| 2 | The manually specified proxy settings are being used. |
| 3 | The proxy settings are being auto-detected. |
Remarks
This method fails unless the calling application is running on the local computer or intranet.
Examples
The following code example uses getProxySettings to display a message, which gives information about the current proxy settings of the Player, in a label. The AxWMPLib.AxWindowsMediaPlayer object is represented by the variable named 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
Requirements
| Requirement | Value |
|---|---|
| Version |
Windows Media Player 9 Series or later |
| Namespace |
WMPLib |
| Assembly |
|