Share via

IConnectorFramework.GetMonitoringAlertsWithBookmarkForTiers Method

  • Article

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

Gets alerts marked for the monitoring connector for each tiered Management Group. 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

'Usage
Dim instance As IConnectorFramework
Dim connectorId As Guid
Dim languageCodes As String
Dim utcBookmarkTime As DateTime
Dim failures As ConnectorTieredOperationFailure()
Dim returnValue As ConnectorMonitoringAlert()

returnValue = instance.GetMonitoringAlertsWithBookmarkForTiers(connectorId, languageCodes, utcBookmarkTime, failures)

Syntax

'Declaration
<FaultContractAttribute(GetType(ObjectNotFoundException))> _
<FaultContractAttribute(GetType(ArgumentNullException))> _
<FaultContractAttribute(GetType(TimeoutException))> _
<FaultContractAttribute(GetType(ServerDisconnectedException))> _
<FaultContractAttribute(GetType(ServiceNotRunningException))> _
<FaultContractAttribute(GetType(UnknownServiceException))> _
<FaultContractAttribute(GetType(UnknownChannelException))> _
<FaultContractAttribute(GetType(UnauthorizedAccessEnterpriseManagementException))> _
<OperationContractAttribute> _
<FaultContractAttribute(GetType(UnknownAuthorizationStoreException))> _
<FaultContractAttribute(GetType(UnknownDatabaseException))> _
<FaultContractAttribute(GetType(InvalidDatabaseDataException))> _
<FaultContractAttribute(GetType(ConnectorInvalidException))> _
Function GetMonitoringAlertsWithBookmarkForTiers ( _
    connectorId As Guid, _
    languageCodes As String, _
    utcBookmarkTime As DateTime, _
    <OutAttribute> ByRef failures As ConnectorTieredOperationFailure() _
) As ConnectorMonitoringAlert()

[FaultContractAttribute(typeof(ObjectNotFoundException))] 
[FaultContractAttribute(typeof(ArgumentNullException))] 
[FaultContractAttribute(typeof(TimeoutException))] 
[FaultContractAttribute(typeof(ServerDisconnectedException))] 
[FaultContractAttribute(typeof(ServiceNotRunningException))] 
[FaultContractAttribute(typeof(UnknownServiceException))] 
[FaultContractAttribute(typeof(UnknownChannelException))] 
[FaultContractAttribute(typeof(UnauthorizedAccessEnterpriseManagementException))] 
[OperationContractAttribute] 
[FaultContractAttribute(typeof(UnknownAuthorizationStoreException))] 
[FaultContractAttribute(typeof(UnknownDatabaseException))] 
[FaultContractAttribute(typeof(InvalidDatabaseDataException))] 
[FaultContractAttribute(typeof(ConnectorInvalidException))] 
ConnectorMonitoringAlert[] GetMonitoringAlertsWithBookmarkForTiers (
    Guid connectorId,
    string languageCodes,
    DateTime utcBookmarkTime,
    out ConnectorTieredOperationFailure[] failures
)

[FaultContractAttribute(typeof(ObjectNotFoundException))] 
[FaultContractAttribute(typeof(ArgumentNullException))] 
[FaultContractAttribute(typeof(TimeoutException))] 
[FaultContractAttribute(typeof(ServerDisconnectedException))] 
[FaultContractAttribute(typeof(ServiceNotRunningException))] 
[FaultContractAttribute(typeof(UnknownServiceException))] 
[FaultContractAttribute(typeof(UnknownChannelException))] 
[FaultContractAttribute(typeof(UnauthorizedAccessEnterpriseManagementException))] 
[OperationContractAttribute] 
[FaultContractAttribute(typeof(UnknownAuthorizationStoreException))] 
[FaultContractAttribute(typeof(UnknownDatabaseException))] 
[FaultContractAttribute(typeof(InvalidDatabaseDataException))] 
[FaultContractAttribute(typeof(ConnectorInvalidException))] 
array<ConnectorMonitoringAlert^>^ GetMonitoringAlertsWithBookmarkForTiers (
    Guid connectorId, 
    String^ languageCodes, 
    DateTime utcBookmarkTime, 
    [OutAttribute] array<ConnectorTieredOperationFailure^>^% failures
)

/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.ObjectNotFoundException) */ 
/** @attribute FaultContractAttribute(System.ArgumentNullException) */ 
/** @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 OperationContractAttribute() */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownAuthorizationStoreException) */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownDatabaseException) */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.InvalidDatabaseDataException) */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.ConnectorInvalidException) */ 
ConnectorMonitoringAlert[] GetMonitoringAlertsWithBookmarkForTiers (
    Guid connectorId, 
    String languageCodes, 
    DateTime utcBookmarkTime, 
    /** @attribute OutAttribute() */ /** @ref */ ConnectorTieredOperationFailure[] failures
)

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.
  • failures
    The array of failures that may have occurred for various tiers.

Return Value

Returns an array of ConnectorMonitoringAlert objects that contain the alerts for the specified monitoring connector.

Remarks

To get a ConnectorMonitoringAlert array collection through a MonitoringConnector:

  1. The monitoring connector must be set up.

  2. The monitoring connector must be initialized.

  3. Alerts must be present.

  4. Alerts must be marked for the monitoring connector.

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

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

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