IFPCAlert::EventsBeforeRaise property

Article
08/27/2012

Applies to: desktop apps only

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.

This property is read/write.

Syntax

HRESULT put_EventsBeforeRaise(
  long lThreshold
);

HRESULT get_EventsBeforeRaise(
  long *plThreshold
);

' Data type: Long

Property EventsBeforeRaise( _
  ByVal lThreshold As long, _
  ByVal plThreshold As long _
) As Long

Property value

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

Error codes

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

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

Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008 R2, Windows Server 2008 with SP2 (64-bit only)
Version	Forefront Threat Management Gateway (TMG) 2010
IDL	Msfpccom.idl
DLL	Msfpccom.dll