Gets alerts marked for the monitoring connector for all configured management tiers. The returned array is limited to the batchSize parameter. 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 IConnectorFramework
Dim connectorId As Guid
Dim languageCodes As String
Dim utcBookmarkTime As DateTime
Dim batchSize As Integer
Dim failures As ConnectorTieredOperationFailure()
Dim returnValue As ConnectorMonitoringAlert()

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

Syntax

Visual Basic 
<FaultContractAttribute(GetType(ServerDisconnectedException))> _
<FaultContractAttribute(GetType(ServiceNotRunningException))> _
<FaultContractAttribute(GetType(UnknownServiceException))> _
<FaultContractAttribute(GetType(UnknownChannelException))> _
<FaultContractAttribute(GetType(UnauthorizedAccessMonitoringException))> _
<FaultContractAttribute(GetType(ObjectNotFoundException))> _
<FaultContractAttribute(GetType(UnknownAuthorizationStoreException))> _
<FaultContractAttribute(GetType(UnknownDatabaseException))> _
<FaultContractAttribute(GetType(InvalidDatabaseDataException))> _
<FaultContractAttribute(GetType(ConnectorInvalidException))> _
<FaultContractAttribute(GetType(ArgumentNullException))> _
<FaultContractAttribute(GetType(InvalidOperationException))> _
<FaultContractAttribute(GetType(TimeoutException))> _
<OperationContractAttribute> _
Function GetMonitoringAlertsWithBookmarkWithBatchSizeForTiers ( _
		connectorId As Guid, _
		languageCodes As String, _
		utcBookmarkTime As DateTime, _
		batchSize As Integer, _
		<OutAttribute> ByRef failures As ConnectorTieredOperationFailure() _
) As ConnectorMonitoringAlert()
C# 
[FaultContractAttribute(typeof(ServerDisconnectedException))] 
[FaultContractAttribute(typeof(ServiceNotRunningException))] 
[FaultContractAttribute(typeof(UnknownServiceException))] 
[FaultContractAttribute(typeof(UnknownChannelException))] 
[FaultContractAttribute(typeof(UnauthorizedAccessMonitoringException))] 
[FaultContractAttribute(typeof(ObjectNotFoundException))] 
[FaultContractAttribute(typeof(UnknownAuthorizationStoreException))] 
[FaultContractAttribute(typeof(UnknownDatabaseException))] 
[FaultContractAttribute(typeof(InvalidDatabaseDataException))] 
[FaultContractAttribute(typeof(ConnectorInvalidException))] 
[FaultContractAttribute(typeof(ArgumentNullException))] 
[FaultContractAttribute(typeof(InvalidOperationException))] 
[FaultContractAttribute(typeof(TimeoutException))] 
[OperationContractAttribute] 
ConnectorMonitoringAlert[] GetMonitoringAlertsWithBookmarkWithBatchSizeForTiers (
		Guid connectorId,
		string languageCodes,
		DateTime utcBookmarkTime,
		int batchSize,
		out ConnectorTieredOperationFailure[] failures
)
C++ 
[FaultContractAttribute(typeof(ServerDisconnectedException))] 
[FaultContractAttribute(typeof(ServiceNotRunningException))] 
[FaultContractAttribute(typeof(UnknownServiceException))] 
[FaultContractAttribute(typeof(UnknownChannelException))] 
[FaultContractAttribute(typeof(UnauthorizedAccessMonitoringException))] 
[FaultContractAttribute(typeof(ObjectNotFoundException))] 
[FaultContractAttribute(typeof(UnknownAuthorizationStoreException))] 
[FaultContractAttribute(typeof(UnknownDatabaseException))] 
[FaultContractAttribute(typeof(InvalidDatabaseDataException))] 
[FaultContractAttribute(typeof(ConnectorInvalidException))] 
[FaultContractAttribute(typeof(ArgumentNullException))] 
[FaultContractAttribute(typeof(InvalidOperationException))] 
[FaultContractAttribute(typeof(TimeoutException))] 
[OperationContractAttribute] 
array<ConnectorMonitoringAlert^>^ GetMonitoringAlertsWithBookmarkWithBatchSizeForTiers (
		Guid connectorId, 
		String^ languageCodes, 
		DateTime utcBookmarkTime, 
		int batchSize, 
		[OutAttribute] array<ConnectorTieredOperationFailure^>^% failures
)
J# 
/** @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.UnauthorizedAccessMonitoringException) */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.ObjectNotFoundException) */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownAuthorizationStoreException) */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownDatabaseException) */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.InvalidDatabaseDataException) */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.ConnectorInvalidException) */ 
/** @attribute FaultContractAttribute(System.ArgumentNullException) */ 
/** @attribute FaultContractAttribute(System.InvalidOperationException) */ 
/** @attribute FaultContractAttribute(System.TimeoutException) */ 
/** @attribute OperationContractAttribute() */ 
ConnectorMonitoringAlert[] GetMonitoringAlertsWithBookmarkWithBatchSizeForTiers (
		Guid connectorId, 
		String languageCodes, 
		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.









languageCodes





A comma-delimited list of language codes. The language code is
an ISO 639-2 three-letter code that corresponds to the values used
by the CultureInfo.ThreeLetterISOLanguageName property.









utcBookmarkTime





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









batchSize





The approximate max batch size to return.









failures





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







Return Value

An array of 
ConnectorMonitoringAlert objects that contain the alerts for
the specified monitoring connector that occurred before the
specified utcBookmarkTime.



Remarks





This method will only retrieve up to the number of
alerts that are specified by the batchSize parameter. This
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 
AcknowledgeMonitoringAlertsForTiers. 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