Microsoft Internet Security and Acceleration Server 2000

FPCProtocolRule Object

The FPCProtocolRule object represents a single ISA protocol rule. A protocol rule defines a set of protocols that are permitted or denied for certain users or IP addresses at certain times. These times are defined by a schedule.

A protocol rule can apply to one of the following:

A specified set of protocols.
All IP traffic. This includes all connection combinations, even those that are not designated as a protocol within the protocols collection.

For example, you could use this object to create a rule that allows the FTP protocol but only during nonbusiness hours. To define a schedule of nonbusiness hours, use the FPCSchedule object.

This object is a member of the FPCProtocolRules collection.

Click here to see the ISA object hierarchy.

Note to C++ Programmers

This object implements the IFPCProtocolRule interface.

Methods

The following table lists the methods of the FPCProtocolRule object.

Method	Description
Refresh	Reads the object's configuration information from persistent storage, discarding any changes to the configuration that were not saved.
Save	Saves the object's configuration to persistent storage.
SetAppliesAlways	Sets the rule to apply always.
SetSchedule	Sets the schedule to which the rule applies.

Properties

The following table lists the properties of the FPCProtocolRule object.

Property	Description
Action	Gets or sets whether the rule allows or denies use of protocols.
AppliesAlways	Gets whether the rule applies at all times.
AppliesToAccounts	Gets the collection of accounts to which the rule applies.
AppliesToMethod	Gets or sets the method used for deciding rule applicability.
ClientAddressSetsExcluded	Gets the collection of client address sets to which the rule does not apply.
ClientAddressSetsUsed	Gets the collection of client address sets to which the rule applies.
Description	Gets or sets the description of the rule.
Enabled	Gets or sets whether the rule is enabled.
Name	Gets or sets the name of the protocol rule.
ProtocolSelectionMethod	Gets or sets whether the rule applies to all IP traffic, all IP traffic exclusive of certain protocols, or to specified protocols.
ScheduleUsed	Gets the name of the FPCRef object that is used to define the times when the rule applies.
SpecifiedProtocols	Gets the FPCRefs collection of protocols for which the rule applies.
VendorParametersSets	Gets a reference to an object for storing and loading of custom data into the FPCProtocolRule object's storage.

Requirements

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