Network.getProxyName-Methode

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

Die getProxyName-Methode ruft den Namen des verwendeten Proxyservers ab.

Syntax

strRetVal = Network.getProxyName(
  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 einen String-Wert zurück, der den Namen des verwendeten Proxyservers enthält. Der zurückgegebene Wert ist nur sinnvoll, wenn getProxySettings den Wert 2 zurückgibt (manuelle Einstellungen verwenden).

Bemerkungen

Bei dieser Methode tritt ein Fehler auf, 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. getProxyName, um die Windows Medienwiedergabe Proxyservernamen für die HTTP- und MMS-Protokolle anzuzeigen. Das Player-Objekt wurde mit der ID = "Player" erstellt.

// Test whether the HTTP proxy settings are manual.
if (Player.network.getProxySettings("HTTP") == 2)

   // Get the proxy server name for HTTP.
   var proxyNameHTTP = Player.network.getProxyName("HTTP");

// Test whether the MMS proxy settings are manual.
if (Player.network.getProxySettings("MMS") == 2)

   // Get the proxy server name for MMS.
   var proxyNameMMS = Player.network.getProxyName("MMS");

// Display the proxy server names in the browser client area.
// Unavailable proxy server names will display as "undefined".
document.write("The current HTTP proxy server name is: " + proxyNameHTTP);
document.write("<BR>");
document.write("The current MMS proxy server name is: " + proxyNameMMS);

Anforderungen

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

Siehe auch

Network-Objekt

Network.getProxySettings