IConnectorFramework.Initialize(Guid) Method

Definition

Namespace:

Microsoft.EnterpriseManagement.ConnectorFramework

Assembly:

Microsoft.EnterpriseManagement.OperationsManager.dll

Initializes the connector for subsequent calls. Will use the currently stored bookmark.

C#

[System.ServiceModel.FaultContract(typeof(Microsoft.EnterpriseManagement.Common.ConnectorInvalidException))]
[System.ServiceModel.FaultContract(typeof(System.TimeoutException))]
[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.ConnectorAlreadyInStateException))]
[System.ServiceModel.FaultContract(typeof(Microsoft.EnterpriseManagement.Common.ServerDisconnectedException))]
[System.ServiceModel.FaultContract(typeof(Microsoft.EnterpriseManagement.Common.ServiceNotRunningException))]
[System.ServiceModel.OperationContract]
public void Initialize (Guid connectorId);

Parameters

connectorId

Guid

The connector id.

Attributes

FaultContractAttribute OperationContractAttribute

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 currently 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 <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