Network.getProxySettings-Methode

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer ersetzt. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, nach Möglichkeit für neuen Code MediaPlayer anstelle von Windows Medienwiedergabe SDK zu verwenden. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die getProxySettings-Methode ruft die Proxyeinstellung für ein bestimmtes Protokoll ab.

Syntax

retVal = Network.getProxySettings(
  protocol
)

Parameter

Protokoll [in]

Zeichenfolge , die den Protokollnamen angibt. Eine Liste der unterstützten Protokolle finden Sie unter Unterstützte Protokolle und Dateitypen.

Rückgabewert

Diese Methode gibt eine Zahl (long) zurück, die einen der folgenden Werte enthält.

Wert	Beschreibung
0	Ein Proxyserver wird nicht verwendet.
1	Die Proxyeinstellungen für den aktuellen Browser werden verwendet (gilt nur für HTTP).
2	Die manuell angegebenen Proxyeinstellungen werden verwendet.
3	Die Proxyeinstellungen werden automatisch erkannt.

Bemerkungen

Diese Methode schlägt fehl, es sei denn, die aufrufende Anwendung wird auf dem lokalen Computer oder Intranet ausgeführt.

Windows Medienwiedergabe 10 Mobile: Diese Methode wird nicht unterstützt.

Beispiele

Im folgenden JScript-Beispiel wird Network verwendet. getProxySettings , um eine Meldung anzuzeigen, die Informationen zu den aktuellen Proxyeinstellungen des Players im Browserfenster enthält. Das Player-Objekt wurde mit der ID = "Player" erstellt.

// 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.");
}

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe Version 7.0 oder höher.
DLL	Wmp.dll

Siehe auch

Netzwerkobjekt