IConnectorFramework.UpdateMonitoringAlerts Method

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Updates the specified alerts.

Namespace: Microsoft.EnterpriseManagement.ConnectorFramework
Assembly: Microsoft.EnterpriseManagement.OperationsManager (in Microsoft.EnterpriseManagement.OperationsManager.dll)

Usage

'Usage
Dim instance As IConnectorFramework
Dim connectorId As Guid
Dim comments As String
Dim alertsToUpdate As ConnectorMonitoringAlert()
Dim returnValue As ConnectorMonitoringAlertUpdateFailure()

returnValue = instance.UpdateMonitoringAlerts(connectorId, comments, alertsToUpdate)

Syntax

'Declaration
<FaultContractAttribute(GetType(ArgumentOutOfRangeException))> _
<FaultContractAttribute(GetType(ConnectorInvalidException))> _
<FaultContractAttribute(GetType(InvalidDatabaseDataException))> _
<FaultContractAttribute(GetType(ArgumentNullException))> _
<OperationContractAttribute> _
<FaultContractAttribute(GetType(TimeoutException))> _
<FaultContractAttribute(GetType(ServerDisconnectedException))> _
<FaultContractAttribute(GetType(ServiceNotRunningException))> _
<FaultContractAttribute(GetType(UnknownServiceException))> _
<FaultContractAttribute(GetType(UnknownChannelException))> _
<FaultContractAttribute(GetType(UnauthorizedAccessEnterpriseManagementException))> _
<FaultContractAttribute(GetType(UnknownAuthorizationStoreException))> _
<FaultContractAttribute(GetType(UnknownDatabaseException))> _
Function UpdateMonitoringAlerts ( _
    connectorId As Guid, _
    comments As String, _
    alertsToUpdate As ConnectorMonitoringAlert() _
) As ConnectorMonitoringAlertUpdateFailure()

[FaultContractAttribute(typeof(ArgumentOutOfRangeException))] 
[FaultContractAttribute(typeof(ConnectorInvalidException))] 
[FaultContractAttribute(typeof(InvalidDatabaseDataException))] 
[FaultContractAttribute(typeof(ArgumentNullException))] 
[OperationContractAttribute] 
[FaultContractAttribute(typeof(TimeoutException))] 
[FaultContractAttribute(typeof(ServerDisconnectedException))] 
[FaultContractAttribute(typeof(ServiceNotRunningException))] 
[FaultContractAttribute(typeof(UnknownServiceException))] 
[FaultContractAttribute(typeof(UnknownChannelException))] 
[FaultContractAttribute(typeof(UnauthorizedAccessEnterpriseManagementException))] 
[FaultContractAttribute(typeof(UnknownAuthorizationStoreException))] 
[FaultContractAttribute(typeof(UnknownDatabaseException))] 
ConnectorMonitoringAlertUpdateFailure[] UpdateMonitoringAlerts (
    Guid connectorId,
    string comments,
    ConnectorMonitoringAlert[] alertsToUpdate
)

[FaultContractAttribute(typeof(ArgumentOutOfRangeException))] 
[FaultContractAttribute(typeof(ConnectorInvalidException))] 
[FaultContractAttribute(typeof(InvalidDatabaseDataException))] 
[FaultContractAttribute(typeof(ArgumentNullException))] 
[OperationContractAttribute] 
[FaultContractAttribute(typeof(TimeoutException))] 
[FaultContractAttribute(typeof(ServerDisconnectedException))] 
[FaultContractAttribute(typeof(ServiceNotRunningException))] 
[FaultContractAttribute(typeof(UnknownServiceException))] 
[FaultContractAttribute(typeof(UnknownChannelException))] 
[FaultContractAttribute(typeof(UnauthorizedAccessEnterpriseManagementException))] 
[FaultContractAttribute(typeof(UnknownAuthorizationStoreException))] 
[FaultContractAttribute(typeof(UnknownDatabaseException))] 
array<ConnectorMonitoringAlertUpdateFailure^>^ UpdateMonitoringAlerts (
    Guid connectorId, 
    String^ comments, 
    array<ConnectorMonitoringAlert^>^ alertsToUpdate
)

/** @attribute FaultContractAttribute(System.ArgumentOutOfRangeException) */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.ConnectorInvalidException) */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.InvalidDatabaseDataException) */ 
/** @attribute FaultContractAttribute(System.ArgumentNullException) */ 
/** @attribute OperationContractAttribute() */ 
/** @attribute FaultContractAttribute(System.TimeoutException) */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.ServerDisconnectedException) */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.ServiceNotRunningException) */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownServiceException) */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownChannelException) */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnauthorizedAccessEnterpriseManagementException) */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownAuthorizationStoreException) */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownDatabaseException) */ 
ConnectorMonitoringAlertUpdateFailure[] UpdateMonitoringAlerts (
    Guid connectorId, 
    String comments, 
    ConnectorMonitoringAlert[] alertsToUpdate
)

FaultContractAttribute(System.ArgumentOutOfRangeException) 
FaultContractAttribute(Microsoft.EnterpriseManagement.Common.ConnectorInvalidException) 
FaultContractAttribute(Microsoft.EnterpriseManagement.Common.InvalidDatabaseDataException) 
FaultContractAttribute(System.ArgumentNullException) 
OperationContractAttribute 
FaultContractAttribute(System.TimeoutException) 
FaultContractAttribute(Microsoft.EnterpriseManagement.Common.ServerDisconnectedException) 
FaultContractAttribute(Microsoft.EnterpriseManagement.Common.ServiceNotRunningException) 
FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownServiceException) 
FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownChannelException) 
FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnauthorizedAccessEnterpriseManagementException) 
FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownAuthorizationStoreException) 
FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownDatabaseException) 
function UpdateMonitoringAlerts (
    connectorId : Guid, 
    comments : String, 
    alertsToUpdate : ConnectorMonitoringAlert[]
) : ConnectorMonitoringAlertUpdateFailure[]

Parameters

• connectorId
  The globally unique identifier (GUID) for the monitoring connector to update alerts for.

• comments
  Comments to apply to the update.

• alertsToUpdate
  An array of ConnectorMonitoringAlert objects to update.

Return Value

Returns an array of ConnectorMonitoringAlertUpdateFailure objects that contain possible errors that occurred during the update.

Remarks

Updates the alerts, including the alert history, to the Operation Manager. The comments are part of the alert history.

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

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows Vista, Windows Server 2003, and

Target Platforms

See Also

Reference

IConnectorFramework Interface
IConnectorFramework Members
Microsoft.EnterpriseManagement.ConnectorFramework Namespace