Initializes the monitoring connector that is required to get alerts by calling GetMonitoringAlertsWithBookmarkForTiers and sets the BookMark time to a specified date and time, for all tiered Management Groups. 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 utcBookmarkTime As DateTime
Dim failures As ConnectorTieredOperationFailure()

instance.InitializeWithBookmarkForTiers(connectorId, utcBookmarkTime, failures)

Syntax

Visual Basic
<FaultContractAttribute(GetType(UnknownDatabaseException))> _
<FaultContractAttribute(GetType(TimeoutException))> _
<FaultContractAttribute(GetType(ServerDisconnectedException))> _
<FaultContractAttribute(GetType(ServiceNotRunningException))> _
<FaultContractAttribute(GetType(UnknownServiceException))> _
<FaultContractAttribute(GetType(UnknownChannelException))> _
<FaultContractAttribute(GetType(UnknownAuthorizationStoreException))> _
<FaultContractAttribute(GetType(UnauthorizedAccessMonitoringException))> _
<FaultContractAttribute(GetType(InvalidDatabaseDataException))> _
<OperationContractAttribute> _
Sub InitializeWithBookmarkForTiers ( _
		connectorId As Guid, _
		utcBookmarkTime As DateTime, _
		<OutAttribute> ByRef failures As ConnectorTieredOperationFailure() _
)
C#
[FaultContractAttribute(typeof(UnknownDatabaseException))] 
[FaultContractAttribute(typeof(TimeoutException))] 
[FaultContractAttribute(typeof(ServerDisconnectedException))] 
[FaultContractAttribute(typeof(ServiceNotRunningException))] 
[FaultContractAttribute(typeof(UnknownServiceException))] 
[FaultContractAttribute(typeof(UnknownChannelException))] 
[FaultContractAttribute(typeof(UnknownAuthorizationStoreException))] 
[FaultContractAttribute(typeof(UnauthorizedAccessMonitoringException))] 
[FaultContractAttribute(typeof(InvalidDatabaseDataException))] 
[OperationContractAttribute] 
void InitializeWithBookmarkForTiers (
		Guid connectorId,
		DateTime utcBookmarkTime,
		out ConnectorTieredOperationFailure[] failures
)
C++
[FaultContractAttribute(typeof(UnknownDatabaseException))] 
[FaultContractAttribute(typeof(TimeoutException))] 
[FaultContractAttribute(typeof(ServerDisconnectedException))] 
[FaultContractAttribute(typeof(ServiceNotRunningException))] 
[FaultContractAttribute(typeof(UnknownServiceException))] 
[FaultContractAttribute(typeof(UnknownChannelException))] 
[FaultContractAttribute(typeof(UnknownAuthorizationStoreException))] 
[FaultContractAttribute(typeof(UnauthorizedAccessMonitoringException))] 
[FaultContractAttribute(typeof(InvalidDatabaseDataException))] 
[OperationContractAttribute] 
void InitializeWithBookmarkForTiers (
		Guid connectorId, 
		DateTime utcBookmarkTime, 
		[OutAttribute] array<ConnectorTieredOperationFailure^>^% failures
)
J#
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownDatabaseException) */ 
/** @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.UnknownAuthorizationStoreException) */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnauthorizedAccessMonitoringException) */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.InvalidDatabaseDataException) */ 
/** @attribute OperationContractAttribute() */ 
void InitializeWithBookmarkForTiers (
		Guid connectorId, 
		DateTime utcBookmarkTime, 
		/** @attribute OutAttribute() */ /** @ref */ ConnectorTieredOperationFailure[] failures
)
JScript

Parameters

connectorId

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

utcBookmarkTime

A timestamp bookmark. The connector's bookmark will be set to this bookmark time.

failures

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

Remarks

The MonitoringConnector must be set up and initialized before any alerts can be retrieved. This method initializes the monitoring connector for subsequent calls with the specified stored bookmark.

Attempting to Initialize a monitoring connector that is already initialized results in an exception with the "The connector is already in the given state." warning. It is advisable to perform a check of the Initialized property to determine if the monitoring connector is already initialized before attempting to Initialize the monitoring connector.


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