Gets alerts for the specified monitoring connector for all the management tiers. You also specify a timestamp bookmark, and all alerts with a timestamp after the bookmark will be returned. The failures that occurred for the configured tiers are returned. Namespace: Microsoft.EnterpriseManagement.ConnectorFramework
Assembly: Microsoft.EnterpriseManagement.OperationsManager (in microsoft.enterprisemanagement.operationsmanager.dll)

Usage

Visual Basic
Dim instance As ConnectorFrameworkProxy
Dim connectorId As Guid
Dim utcBookmarkTime As DateTime
Dim batchSize As Integer
Dim failures As ConnectorTieredOperationFailure()
Dim returnValue As ConnectorMonitoringAlert()

returnValue = instance.GetMonitoringAlertsWithBookmarkWithBatchSizeForTiers(connectorId, utcBookmarkTime, batchSize, failures)

Syntax

Visual Basic
Public Function GetMonitoringAlertsWithBookmarkWithBatchSizeForTiers ( _
		connectorId As Guid, _
		utcBookmarkTime As DateTime, _
		batchSize As Integer, _
		<OutAttribute> ByRef failures As ConnectorTieredOperationFailure() _
) As ConnectorMonitoringAlert()
C#
public ConnectorMonitoringAlert[] GetMonitoringAlertsWithBookmarkWithBatchSizeForTiers (
		Guid connectorId,
		DateTime utcBookmarkTime,
		int batchSize,
		out ConnectorTieredOperationFailure[] failures
)
C++
public:
array<ConnectorMonitoringAlert^>^ GetMonitoringAlertsWithBookmarkWithBatchSizeForTiers (
		Guid connectorId, 
		DateTime utcBookmarkTime, 
		int batchSize, 
		[OutAttribute] array<ConnectorTieredOperationFailure^>^% failures
)
J#
public ConnectorMonitoringAlert[] GetMonitoringAlertsWithBookmarkWithBatchSizeForTiers (
		Guid connectorId, 
		DateTime utcBookmarkTime, 
		int batchSize, 
		/** @attribute OutAttribute() */ /** @ref */ ConnectorTieredOperationFailure[] failures
)
JScript

Parameters

connectorId

The globally unique identifier (GUID) for the monitoring connector to get alerts for.

utcBookmarkTime

A timestamp bookmark. All alerts with a timestamp prior to this will be returned.

batchSize

The approximate maximum batch size to return.

failures

The array of failures that may have occurred for various tiers.

Return Value

An array of ConnectorMonitoringAlert objects, limited to batchSize, that contain the alerts for the specified monitoring connector.

Remarks

This method gets all alerts assigned to a specific monitoring connector after the specified bookmark date and time.

The batchSize limitation allows you to perform the get monitoring alerts operation in small batches, thereby avoiding a time-out failure. The batchSize is the total across all tiers, not per tier.

It is good practice to limit the number of alerts obtained by a single call. When you perform this GetMonitoringAlertsWithBookmarkWithBatchSizeForTiers method you should check to see if the count property of the returned collection equals or exceeds the batchSize. If the count property of the returned collection equals or exceeds the batchSize then you should acknowledge the alerts received, and call this function again to get the next batch of alerts. Only when the returned collection is smaller than the batchSize can you be sure that you have received all of the alerts.

This method gets alerts only from the bookmark date to the current time less 30 seconds.

After you get the monitoring alert, you need to acknowledge that alert with an AcknowledgeMonitoringAlerts. Failure to acknowledge an alert will result in subsequent calls to get new alerts returning the already received alerts.


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 Server 2008, Windows Vista, Windows Server 2003, and Windows XP

Target Platforms

Windows Server 2008,Windows Server 2003,Windows Vista,Windows XP

See Also