IConnectorFramework.Initialize Method

Updated: April 16, 2012

Initializes the monitoring connector that is required to get alerts by calling GetMonitoringAlerts. Namespace: Microsoft.EnterpriseManagement.ConnectorFramework
Assembly: Microsoft.EnterpriseManagement.OperationsManager (in Microsoft.EnterpriseManagement.OperationsManager.dll)Dim instance As IConnectorFramework Dim connectorId As Guid instance.Initialize(connectorId)<FaultContractAttribute(GetType(ConnectorInvalidException))> _ <FaultContractAttribute(GetType(TimeoutException))> _ <FaultContractAttribute(GetType(UnknownServiceException))> _ <FaultContractAttribute(GetType(UnknownChannelException))> _ <FaultContractAttribute(GetType(UnauthorizedAccessEnterpriseManagementException))> _ <FaultContractAttribute(GetType(UnknownAuthorizationStoreException))> _ <FaultContractAttribute(GetType(UnknownDatabaseException))> _ <FaultContractAttribute(GetType(InvalidDatabaseDataException))> _ <OperationContractAttribute> _ <FaultContractAttribute(GetType(ConnectorAlreadyInStateException))> _ <FaultContractAttribute(GetType(ServerDisconnectedException))> _ <FaultContractAttribute(GetType(ServiceNotRunningException))> _ Sub Initialize ( _ connectorId As Guid _ )[FaultContractAttribute(typeof(ConnectorInvalidException))] [FaultContractAttribute(typeof(TimeoutException))] [FaultContractAttribute(typeof(UnknownServiceException))] [FaultContractAttribute(typeof(UnknownChannelException))] [FaultContractAttribute(typeof(UnauthorizedAccessEnterpriseManagementException))] [FaultContractAttribute(typeof(UnknownAuthorizationStoreException))] [FaultContractAttribute(typeof(UnknownDatabaseException))] [FaultContractAttribute(typeof(InvalidDatabaseDataException))] [OperationContractAttribute] [FaultContractAttribute(typeof(ConnectorAlreadyInStateException))] [FaultContractAttribute(typeof(ServerDisconnectedException))] [FaultContractAttribute(typeof(ServiceNotRunningException))] void Initialize ( Guid connectorId )[FaultContractAttribute(typeof(ConnectorInvalidException))] [FaultContractAttribute(typeof(TimeoutException))] [FaultContractAttribute(typeof(UnknownServiceException))] [FaultContractAttribute(typeof(UnknownChannelException))] [FaultContractAttribute(typeof(UnauthorizedAccessEnterpriseManagementException))] [FaultContractAttribute(typeof(UnknownAuthorizationStoreException))] [FaultContractAttribute(typeof(UnknownDatabaseException))] [FaultContractAttribute(typeof(InvalidDatabaseDataException))] [OperationContractAttribute] [FaultContractAttribute(typeof(ConnectorAlreadyInStateException))] [FaultContractAttribute(typeof(ServerDisconnectedException))] [FaultContractAttribute(typeof(ServiceNotRunningException))] void Initialize ( Guid connectorId )/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.ConnectorInvalidException) */ /** @attribute FaultContractAttribute(System.TimeoutException) */ /** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownServiceException) */ /** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownChannelException) */ /** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnauthorizedAccessEnterpriseManagementException) */ /** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownAuthorizationStoreException) */ /** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownDatabaseException) */ /** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.InvalidDatabaseDataException) */ /** @attribute OperationContractAttribute() */ /** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.ConnectorAlreadyInStateException) */ /** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.ServerDisconnectedException) */ /** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.ServiceNotRunningException) */ void Initialize ( Guid connectorId )FaultContractAttribute(Microsoft.EnterpriseManagement.Common.ConnectorInvalidException) FaultContractAttribute(System.TimeoutException) FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownServiceException) FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownChannelException) FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnauthorizedAccessEnterpriseManagementException) FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownAuthorizationStoreException) FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownDatabaseException) FaultContractAttribute(Microsoft.EnterpriseManagement.Common.InvalidDatabaseDataException) OperationContractAttribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.ConnectorAlreadyInStateException) FaultContractAttribute(Microsoft.EnterpriseManagement.Common.ServerDisconnectedException) FaultContractAttribute(Microsoft.EnterpriseManagement.Common.ServiceNotRunningException) function Initialize ( connectorId : Guid )ParametersconnectorIdThe globally unique identifier (GUID) for the monitoring connector to initialize.

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 Initialized property to determine if the monitoring connector is already initialized before attempting to Initialize the monitoring connector.


Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Development Platforms

Windows Vista, Windows Server 2003, and

Target Platforms