Microsoft Internet Security and Acceleration Server 2004 SDK

MinEventsPerSecond Property of IFPCEventDefinition[C++]

FPCEventDefinition.MinEventsPerSecond [Visual Basic]

[C++]

The MinEventsPerSecond property gets or sets the default number of times in a second that the event must be signaled before an alert that is issued for the event can be issued.

HRESULT get_MinEventsPerSecond(
  long* plThreshold
);

HRESULT put_MinEventsPerSecond(
  long lThreshold
);

Parameters

plThreshold
Pointer to a variable that receives a 32-bit integer specifying the default event frequency threshold.
lThreshold
A 32-bit integer that specifies the default event frequency threshold.

Return Values

This property method returns S_OK if the call is successful; otherwise, it returns an error code.

Remarks

This property is read/write.

This property only establishes a default value for an event. When you create an alert, the alert can use the default value, or you can overwrite it with values specific to the alert by modifying the corresponding property in the FPCAlert object.

The MinutesBeforeReRaise, EventsBeforeRaise, and MinEventsPerSecond properties of the FPCAlert object set the three thresholds that the Microsoft Firewall service uses to issue alerts. For each alert, the Microsoft Firewall service stores the time when the event last occurred, a count of how many times the event has occurred per second, and a count of the total number of times that the event has occurred. An alert is issued and the alert invokes the actions defined for it only when the three threshold requirements for issuing the alert are met simultaneously.

[Visual Basic]

The MinEventsPerSecond property gets or sets the default number of times in a second that the event must be signaled before an alert that is issued for the event can be issued.

Property MinEventsPerSecond As Long

Property Value

A 32-bit integer that specifies the event frequency threshold.

Remarks

This property is read/write.

This property only establishes a default value for an event. When you create an alert, the alert can use the default value, or you can overwrite it with values specific to the alert by modifying the corresponding property in the FPCAlert object.

The MinutesBeforeReRaise, EventsBeforeRaise, and MinEventsPerSecond properties of the FPCAlert object set the three thresholds that the Microsoft Firewall service uses to issue alerts. For each alert, the Microsoft Firewall service stores the time when the event last occurred, a count of how many times the event has occurred per second, and a count of the total number of times that the event has occurred. An alert is issued and the alert invokes the actions defined for it only when the three threshold requirements for issuing the alert are met simultaneously.

Requirements

Server: Requires Windows Server 2003 or Windows 2000.
Version: Requires Internet Security and Acceleration Server 2004.
Header: Declared in Msfpccom.idl.
Library: Use Microsoft Internet Security and Acceleration Server 2004 Administration Library.

See Also

FPCEventDefinition