FrameworkBase.UpdateAlerts Method

Article
09/06/2006

Sends information about an updated alert, including its alert history, to the MOM server.

 public abstract UpdateAlertsResults FrameworkBase.UpdateAlerts(
    Guid registrationId,
    AlertUpdate[] alerts
);

Parameters

registrationId
The connector's registration ID. The registration ID is obtained from the initial call to the FrameworkBase.Setup method.
alerts
An AlertUpdate array containing alert information.

Return Value

UpdateAlertsResults

Exceptions

Exception Type	Condition
System.ArgumentOutOfRangeException	One or more AlertUpdate field values are outside their valid range.
System.InvalidOperationException	The registrationId value is valid.

Remarks

To improve performance when updating large numbers of alerts, send no more than 1000 updated alerts in each call to the UpdateAlerts method.

The UpdateAlerts method does not roll back changes when an error occurs. The UpdateAlertsResults return value contains information about which alerts were successfully updated. If an error occurs within the UpdateAlerts method, some alerts might not be updated.

When calling this method, the AlertUpdate objects are serialized as XML data. AlertUpdate property values that contain characters that are considered invalid within XML should be handled before calling the method. For more information about character sets and XML, see section 2.2 of the Extensible Markup Language (XML) 1.0 (Second Edition) W3C recommendation.

Requirements

Platforms: Requires Windows 2000 Server or later

Version: Requires MOM 2000 SP1 or later

Namespace: Microsoft.EnterpriseManagement.Mom.Connector

Assembly: MomConnectorFramework (in MomConnectorFramework.dll)

Share via