Microsoft Internet Security and Acceleration Server 2000

FPCRefs Collection

The FPCRefs collection represents a group of objects that are used by a rule. FPCRefs can contain references to client address sets, protocols, or content groups. Note that each instance of FPCRefs will contain a homogenous set of FPCRef objects.

The FPCRef object is used to reference another object. You can use the FPCRef object and the FPCRefs collection to retrieve values needed for specific scripting situations. Here are several lines of VBScript code demonstrating use of FPCRef and FPCRefs:

'Using the FPCRefs.Add method to add an FPCRef object reference to 
'a client address set to the list of excluded address sets
objarr.ArrayPolicy.SiteAndContentRules (1).ClientAddressSetsExcluded.Add "ClientSet_1"
'Using the FPCRef.Name property to retrieve the name of an excluded 
'client address set
objarr.ArrayPolicy.SiteAndContentRules (1).ClientAddressSetsExcluded(1).Name 

A full example using FPCRefs is provided in Creating and Applying Enterprise Policy to an Array. FPCRefs is also used in Preventing Access in a Web Publishing Scenario.

The FPCRefs collection is a property of the FPCSiteAndContentRule, FPCWebPublishingRule, FPCBandwidthRule, and FPCProtocolRule objects.

Click here to see the ISA object hierarchy.

Note to C++ Programmers

This collection implements the IFPCRefs interface.


The following table lists the methods of the FPCRefs collection.

Method Description
Add Adds a new FPCRef object to the collection.
Exists Returns TRUE if an object having the specified properties currently exists in the collection.
Item Retrieves the given FPCRef object from the collection.
Refresh Reads the collection's configuration information from persistent storage, discarding any changes to the configuration that were not saved.
Remove Removes an FPCRef object from the collection.
RemoveAll Removes all entries from the collection.
RemoveSpecified Removes an object identified by its properties.
Save Saves the collection's configuration to persistent storage.


The following table lists the properties of the FPCRefs collection.

Property Description
Count Gets the number of items collection.
VendorParametersSets Not implemented for this object.


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