EventsBeforeRaise Property of the IFPCAlert Interface

Article
08/13/2010

The EventsBeforeRaise property gets or sets the minimal number of occurrences of the event for which the alert is issued before the alert can be issued.
The MinutesBeforeReRaise, EventsBeforeRaise, and MinEventsPerSecond properties set the three thresholds that the Microsoft Firewall service uses to issue alerts. For each alert, the 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.
The EventsBeforeRaise property sets the threshold number of occurrences of the event.

C++

HRESULT put_EventsBeforeRaise(
    long lThreshold
);
HRESULT get_EventsBeforeRaise(
    long* plThreshold
);

Parameters

lThreshold
A 32-bit integer that specifies the threshold number of occurrences of the event.
plThreshold
Pointer to a variable that on return receives a 32-bit integer specifying the threshold number of occurrences of the event.

Return Value

These property methods return S_OK if the call is successful; otherwise, they return an error code.

Visual Basic

Property EventsBeforeRaise As Long

Property Value

A 32-bit integer that specifies the threshold number of occurrences of the event.

Remarks

This property is read/write. Its default value is specified by the value of the EventsBeforeRaise property of the applicable FPCEventDefinition object, and its range of permissible values is from 0 through 999,999,999.

Requirements

Client	Requires Windows 7 or Windows Vista.
Server	Requires Windows Server 2008 R2 or Windows Server 2008 x64 Edition with SP2.
Version	Requires Forefront Threat Management Gateway (TMG) 2010.
IDL	Declared in Msfpccom.idl.
DLL	Requires Msfpccom.dll.

Share via