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.

Methods

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.

Properties

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.

Requirements

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