web_set_proxy_bypass

Specifies the list of URLs that the script can access directly, bypassing the proxy server.

C Language

int web_set_proxy_bypass( const char *bypass1..n ); 

Java Language

int object.set_proxy_bypass( String bypass1..n ); 
Argument
Description
object
An expression evaluating to an object of type WebApi. Usually web for Java. See also Function and Constant Prefixes.
bypass1..n
The list of URLs that scripts can access directly that is, not via the specified proxy server. Each URL is separated by a semi-colon (;). Each entry has a format "host:port". This instructs scripts to bypass all the files on the specified host:port.

Return Values

This function returns LR_PASS (0) on success, and LR_FAIL (1) on failure.

Parameterization

The following argument(s) can be parameterized using standard parameterization: bypass1.n

General Information

The web_set_proxy_bypass function is a service function that specifies a list of URLs to access directly, bypassing the proxy server. You can include <local> in the list of by-passed URLs to bypass the proxy server for all the local hosts (such as intranet servers).

Using the empty string ("") resets all the bypass settings.

Note: The bypass lists are NOT incremental. Each call to web_set_proxy_bypass resets the previous settings.

This function is supported for all web scripts.

C Example

The following example specifies that scripts access all local hosts and all www.ABC.com sites directly, without using the proxy server:

web_set_proxy_bypass("<local>;www.abc.com");

Java Example

The following example specifies that scripts access all local hosts and all www.abc.com sites directly, without using the proxy server: 

web.set_proxy_bypass("<local>;www.abc.com");

Note that the warning message can be ignored:

Warning: The string 'local' with parameter delimiters is not a parameter.