Network.getProxySettings 方法

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 如果可能，Microsoft 强烈建议新代码使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

getProxySettings 方法检索给定协议的代理设置。

语法

retVal = Network.getProxySettings(
  protocol
)

参数

协议 [in]

指定协议名称的字符串。 有关受支持协议的列表，请参阅 支持的协议和文件类型。

返回值

此方法返回包含下列值之一的 Number (长) 。

值	说明
0	未使用代理服务器。
1	当前浏览器的代理设置使用 (仅对 HTTP) 有效。
2	正在使用手动指定的代理设置。
3	正在自动检测代理设置。

备注

除非调用应用程序在本地计算机或 Intranet 上运行，否则此方法将失败。

Windows 媒体播放器 10 移动版：不支持此方法。

示例

以下 JScript 示例使用 网络。getProxySettings 用于在浏览器窗口中显示一条消息，该消息提供有关 Player 的当前代理设置的信息。 创建的 Player 对象 ID 为“Player”。

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

// Display the message the corresponds to the current settings.
switch(proxySetting){

   case 0:
     document.write("A proxy server is not being used");
     break;

   case 1: 
     document.write("The proxy settings for the current browser are being used.");
     break;

   case 2:
     document.write("The manually specified proxy settings are being used.");
     break;

case 3:
     document.write("The proxy settings are being auto-detected.");
     break;

   default:
     document.write("Unable to determine proxy setting, try again.");
}

要求

要求	值
版本	Windows 媒体播放器版本 7.0 或更高版本。
DLL	Wmp.dll

另请参阅

网络对象