IConnectorFramework.InitializeWithBookmark(Guid, DateTime) Method

Definition

Initializes the connector for subsequent calls and sets the connectors bookmark to the provided bookmark time.

public:
 void InitializeWithBookmark(Guid connectorId, DateTime utcBookmarkTime);
[System.ServiceModel.FaultContract(typeof(Microsoft.EnterpriseManagement.Common.ServiceNotRunningException))]
[System.ServiceModel.FaultContract(typeof(Microsoft.EnterpriseManagement.Common.UnknownServiceException))]
[System.ServiceModel.FaultContract(typeof(Microsoft.EnterpriseManagement.Common.UnknownChannelException))]
[System.ServiceModel.FaultContract(typeof(Microsoft.EnterpriseManagement.Common.UnauthorizedAccessEnterpriseManagementException))]
[System.ServiceModel.FaultContract(typeof(Microsoft.EnterpriseManagement.Common.UnknownAuthorizationStoreException))]
[System.ServiceModel.FaultContract(typeof(Microsoft.EnterpriseManagement.Common.UnknownDatabaseException))]
[System.ServiceModel.FaultContract(typeof(Microsoft.EnterpriseManagement.Common.InvalidDatabaseDataException))]
[System.ServiceModel.FaultContract(typeof(Microsoft.EnterpriseManagement.Common.ConnectorInvalidException))]
[System.ServiceModel.FaultContract(typeof(Microsoft.EnterpriseManagement.Common.ConnectorAlreadyInStateException))]
[System.ServiceModel.FaultContract(typeof(System.TimeoutException))]
[System.ServiceModel.FaultContract(typeof(Microsoft.EnterpriseManagement.Common.ServerDisconnectedException))]
[System.ServiceModel.OperationContract]
public void InitializeWithBookmark (Guid connectorId, DateTime utcBookmarkTime);
abstract member InitializeWithBookmark : Guid * DateTime -> unit
Public Sub InitializeWithBookmark (connectorId As Guid, utcBookmarkTime As DateTime)

Parameters

connectorId
Guid

The connector id.

utcBookmarkTime
DateTime

The new bookmark.

Attributes

Remarks

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

All alerts with a timestamp prior the utcBookmarkTime will be ignored.

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 <xref:Microsoft.EnterpriseManagement.ConnectorFramework.MonitoringConnector.Initialized%2A> property to determine if the monitoring connector is already initialized before attempting to Initialize the monitoring connector.

Applies to