Microsoft Internet Security and Acceleration Server 2000

FPC Object

The FPC object is the root of the administration object hierarchy, and provides programmatic access to all of the other FPC objects. For a diagram of the entire hierarchy, see ISA Server Administration Object Model.

Creating this root object is the first step in making any programmatic changes to ISA. Using Visual Basic, you can create it with the following code:

  Dim objFPC As New FPCLib.FPC

The CreateObject function is also available to Visual Basic programmers, and alternatively, the following can be used:

  Dim objFPC
  Set objFPC = CreateObject("FPC.Root")

After the FPC object is created, objects below it in the hierarchy can be accessed through the properties of the root object. The Arrays property returns a collection of all ISA arrays within the root node, and it is through this property that you can access and change configuration settings of server arrays.

For multiple examples of use of the FPC root object, see ISA Administration Scripting.

Click here to see the ISA object hierarchy.

Note to C++ Programmers

This object implements the IFPC interface.

Remarks

When working from an administration-only computer, do not use the FPC object, as it will not provide access to the enterprise. Scripts run from an administration-only computer should use the FPCDS object, which is functionally identical to the FPC object but provides access to the active directory and therefore, to the enterprise.

In Visual Basic, create the root object for remote administration by using the following code:

  Dim objFPC As New FPCLib.FPCDS

Optionally, you can use the CreateObject function:

  Dim objFPC
  Set objFPC = CreateObject("FPCDS.Root")

The following table compares the FPC and FPCDS objects based on the type of installation on which the object is used.

Installation Scenario	FPC Functionality	FPCDS Functionality
Remote administration only	Fails because FPC looks on that computer for an array.	Works for all arrays for which administrator has permissions.
Stand-alone server	Works, but only for the stand-alone server.	Works for all arrays, but not for astand-alone server.
Array	Works for all arrays for which administrator has permissions.	Works for all arrays for which administrator has permissions.

Note In the remote administration only scenario, you can create an FPC object on a remote stand-alone server by using

  Dim objFPC
  Set objFPC = CreateObject("FPC.Root", <ComputerName>)

Where <ComputerName> is the name of the computer on which the object should be created.

Methods

The following table lists the methods of the FPC root object.

Method	Description
Refresh	Reads the object's configuration information from persistent storage, discarding any changes to the configuration that were not saved.

Properties

The following table lists the properties of the FPC root object.

Property	Description
Arrays	Gets a collection of all ISA arrays.
Enterprise	Gets an object that defines enterprise policy settings.
Type	Gets the type of the array.
VendorParametersSets	Gets a reference to an object that stores vendor-specific data.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires ISA Server 2000.
  Header: Msfpccom.idl.