Microsoft Internet Security and Acceleration Server 2000

FPCAlert Object

The FPCAlert object defines an alert. When a specific event occurs, this object determines the actions to be taken in response to that event. The FPCAlert object also defines the three thresholds that determine when actions will be taken. Alerts allow for an administrator to be notified when certain events take place, and to decide which actions should be taken in advance. Properties of the actions to be taken are accessed through the FPCAlertActions collection.

For a more detailed example of using the FPCAlert object, see Adding a Custom Event and Alert.

This object is a member of the FPCAlerts collection.

Click here to see the ISA object hierarchy.

Note to C++ Programmers

This object implements the IFPCAlert interface.

Methods

The following table lists the methods of the FPCAlert 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.
SetDefinitions Sets the following definitions of the alert: event GUID, server name, and the additional key. The three must be set simultaneously because they should form a unique triplet.

Properties

The following table lists the properties of the FPCAlert object.

Property Description
Actions Gets a reference to the FPCAlertActions collection.
AdditionalKey Gets the index to the additional key table of the event associated with this alert.
Description Gets or sets the description of the alert object.
Enabled Gets or sets whether the alert is enabled.
EventGUID Gets the GUID of the event type on which the alert is based.
EventsBeforeRaise Gets or sets a minimal number of events that trigger the alert before the alert's actions can be executed.
MinEventsPerSecond Gets or sets a minimal frequency of events that trigger the alert before the alert's actions can be executed.
MinutesBeforeReRaise Gets or sets a time interval to wait before alert's actions can be executed again.
Name Gets or sets the name of the alert object.
Password Sets the password for the credentials of the command-line action.
ServerName Gets the name of the server allowed to signal this alert.
UserName Gets or sets the user name for the credentials of the command-line action.
VendorParametersSets Gets a reference to an object for storing and loading of custom data into the FPCAlert object's storage.

Requirements

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