Network.setProxyExceptionList method

The setProxyExceptionList method specifies the proxy exception list.

Syntax


Network.setProxyExceptionList(
  protocol,
  list
)

Parameters

protocol [in]

String specifying the protocol name. For a list of supported protocols, see Supported Protocols and File Types.

list [in]

String specifying a semicolon-delimited list of hosts for which the proxy server is bypassed.

Return value

This method does not return a value.

Remarks

This is a list of computers, domains, and/or addresses that will bypass the proxy server when the host portion of the target URL matches an entry in the list.

The * character can be used as a wildcard for listing entries. For example, *.com would match all hosts in the com domain, while 67.* would match all hosts in the 67 class A subnet.

This method has no effect unless getProxySettings returns a value of 2 (use manual settings).

This method fails unless the calling application is running on the local computer or intranet.

Windows Media Player 10 Mobile: This method is not supported.

Examples

The following JScript example uses Network.setProxyExceptionList to specify a list of hosts for which the proxy server is bypassed when using the MMS protocol. The new list is retrieved from an HTML TEXT element with ID = "XLIST". The Player object was created with ID = "Player".



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

   // Store the user's new exception list.
   var proxyxlist = XLIST.value;

   // Set the exception list.
   Player.network.setProxyExceptionList("MMS", proxyxlist);
}

else

// Warn that the proxy settings must be set to 2.
alert("Proxy settings must be manual!");



Requirements

Version

Windows Media Player version 7.0 or later.

DLL

Wmp.dll

See also

Network Object

 

 

Show: