Compartir a través de


IConnectorFramework.InitializeWithBookmark Method (Guid, DateTime)

 

Applies To: Operations Manager for System Center 2012

Initializes the monitoring connector that is required to get alerts by calling GetMonitoringAlertsWithBookmark and sets the BookMark time to a specified date and time.

Namespace:   Microsoft.EnterpriseManagement.ConnectorFramework
Assembly:  Microsoft.EnterpriseManagement.OperationsManager (in Microsoft.EnterpriseManagement.OperationsManager.dll)

Syntax

[FaultContractAttribute(typeof(ServiceNotRunningException))]
[OperationContractAttribute]
[FaultContractAttribute(typeof(UnknownServiceException))]
[FaultContractAttribute(typeof(UnknownChannelException))]
[FaultContractAttribute(typeof(UnauthorizedAccessEnterpriseManagementException))]
[FaultContractAttribute(typeof(UnknownAuthorizationStoreException))]
[FaultContractAttribute(typeof(UnknownDatabaseException))]
[FaultContractAttribute(typeof(InvalidDatabaseDataException))]
[FaultContractAttribute(typeof(ConnectorInvalidException))]
[FaultContractAttribute(typeof(ConnectorAlreadyInStateException))]
[FaultContractAttribute(typeof(TimeoutException))]
[FaultContractAttribute(typeof(ServerDisconnectedException))]
void InitializeWithBookmark(
    Guid connectorId,
    DateTime utcBookmarkTime
)
[FaultContractAttribute((ServiceNotRunningException^::typeid))]
[OperationContractAttribute]
[FaultContractAttribute((UnknownServiceException^::typeid))]
[FaultContractAttribute((UnknownChannelException^::typeid))]
[FaultContractAttribute((UnauthorizedAccessEnterpriseManagementException^::typeid))]
[FaultContractAttribute((UnknownAuthorizationStoreException^::typeid))]
[FaultContractAttribute((UnknownDatabaseException^::typeid))]
[FaultContractAttribute((InvalidDatabaseDataException^::typeid))]
[FaultContractAttribute((ConnectorInvalidException^::typeid))]
[FaultContractAttribute((ConnectorAlreadyInStateException^::typeid))]
[FaultContractAttribute((TimeoutException^::typeid))]
[FaultContractAttribute((ServerDisconnectedException^::typeid))]
void InitializeWithBookmark(
    Guid connectorId,
    DateTime utcBookmarkTime
)
[<FaultContractAttribute(typeof(ServiceNotRunningException))>]
[<OperationContractAttribute>]
[<FaultContractAttribute(typeof(UnknownServiceException))>]
[<FaultContractAttribute(typeof(UnknownChannelException))>]
[<FaultContractAttribute(typeof(UnauthorizedAccessEnterpriseManagementException))>]
[<FaultContractAttribute(typeof(UnknownAuthorizationStoreException))>]
[<FaultContractAttribute(typeof(UnknownDatabaseException))>]
[<FaultContractAttribute(typeof(InvalidDatabaseDataException))>]
[<FaultContractAttribute(typeof(ConnectorInvalidException))>]
[<FaultContractAttribute(typeof(ConnectorAlreadyInStateException))>]
[<FaultContractAttribute(typeof(TimeoutException))>]
[<FaultContractAttribute(typeof(ServerDisconnectedException))>]
abstract InitializeWithBookmark : 
        connectorId:Guid *
        utcBookmarkTime:DateTime -> unit
<FaultContractAttribute(GetType(ServiceNotRunningException))>
<OperationContractAttribute>
<FaultContractAttribute(GetType(UnknownServiceException))>
<FaultContractAttribute(GetType(UnknownChannelException))>
<FaultContractAttribute(GetType(UnauthorizedAccessEnterpriseManagementException))>
<FaultContractAttribute(GetType(UnknownAuthorizationStoreException))>
<FaultContractAttribute(GetType(UnknownDatabaseException))>
<FaultContractAttribute(GetType(InvalidDatabaseDataException))>
<FaultContractAttribute(GetType(ConnectorInvalidException))>
<FaultContractAttribute(GetType(ConnectorAlreadyInStateException))>
<FaultContractAttribute(GetType(TimeoutException))>
<FaultContractAttribute(GetType(ServerDisconnectedException))>
Sub InitializeWithBookmark (
    connectorId As Guid,
    utcBookmarkTime As Date
)

Parameters

  • connectorId
    Type: System.Guid

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

  • utcBookmarkTime
    Type: System.DateTime

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

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

See Also

IConnectorFramework Interface
Microsoft.EnterpriseManagement.ConnectorFramework Namespace

Return to top