Export (0) Print
Expand All

FPCClientAutoScript

Internet Security and Acceleration Server 2004/2006 SDK

The FPCClientAutoScript object defines the contents of the default automatic configuration script that can be used by Web browsers running on client computers in a network.

You can set the properties of the FPCWebBrowserClientConfig object so that Web browsers running on Firewall clients will be configured to use the automatic configuration script stored at the default location on the ISA Server computer. In particular, Web browsers running on Firewall clients use the default automatic configuration script if the BrowserConfigScriptEnabled property is set to True and the BrowserConfigScriptFlag property is set to fpcBrowserDefaultScript. This script is then downloaded and executed by a Web browser running on a Firewall client every time that the Web browser sends a request for a URL.

Because the configuration script is automatically made available to the Web browsers running on Firewall clients, you can update the Web browser settings on all Firewall clients without having to reconfigure the Web browser on each client computer.

Alternatively, you can construct your own custom automatic configuration script and place it on a Web server. When a Web browser looks for the configuration script at the URL that you specify, the Web server receives the request and returns the custom automatic configuration script to the browser.

Web browsers running on client computers on which the Firewall Client software is not installed can be configured manually to use the default automatic configuration script (at http://<ISA_Server_computer>:<HTTP_port>/Array.dll?Get.Routing.Script).

In ISA Server Enterprise Edition, the automatic configuration script also implements the Cache Array Routing Protocol (CARP) algorithm for selecting the Web proxy that can serve a request for a specific URL. A Web browser runs this script for each URL requested, and the CARP algorithm generates a prioritized list of array members that the Web browser should contact to retrieve the object specified by the URL being requested. For more information about the CARP algorithm, see Cache Array Routing Protocol.

The FPCClientAutoScript object can be accessed through the AutoScript property of an FPCWebBrowserClientConfig object.

Click here to see the ISA Server object hierarchy.

Methods

The FPCClientAutoScript object defines the following methods.

Method Description
Refresh Recursively reads all the values of the properties of the object, including all the properties of its subobjects and their elements (for collections), from persistent storage, discarding any changes that were not saved.
Save Recursively writes the current values of all the properties of the object, including all the properties of its subobjects and their elements (for collections), to persistent storage.

Properties

The FPCClientAutoScript object has the following properties.

Property Description
BackupRoute Gets an FPCClientBackupRoute object that represents the backup route settings in the default automatic configuration script for Web browsers running on client computers.
BypassLocalServers Gets or sets a Boolean value that indicates whether Web browsers configured to use the default automatic configuration script will bypass the Web proxy for requests sent to non-dotted names.
DirectAddressDestinations Gets an FPCPublicNames collection containing the domain names of destinations that Web browsers configured to use the default automatic configuration script will access directly, bypassing the Web proxy.
DirectIpDestinations Gets an FPCIpRangeSet collection containing the ranges of IP addresses that Web browsers configured to use the default automatic configuration script will access directly, bypassing the Web proxy.
IncludeLDT Gets or sets a Boolean value that indicates whether the local domain table (LDT) is to be included in the list of directly accessed servers.
IncludeNetworkIpRangeSet Gets or sets a Boolean value that indicates whether the IP address ranges of the network are to be included in the list of directly accessed servers. (This property is introduced in ISA Server 2006.)

Interfaces for C++ Programming

This object implements the IFPCClientAutoScript and IFPCClientAutoScript2 interfaces.

Requirements

Client Requires Windows XP.
Server Requires Windows Server 2003. Requires Windows Server 2003 or Windows 2000 for ISA Server 2004 Standard Edition.
Version Requires Internet Security and Acceleration (ISA) Server 2006 or ISA Server 2004.
IDL

Declared in Msfpccom.idl.

See Also

COM Objects

Show:
© 2014 Microsoft