Gets the state of the specified monitoring connector. 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 returnValue As ConnectorState

returnValue = instance.GetConnectorState(connectorId)

Syntax

Visual Basic
<OperationContractAttribute> _
<FaultContractAttribute(GetType(ConnectorInvalidException))> _
<FaultContractAttribute(GetType(TimeoutException))> _
<FaultContractAttribute(GetType(ServerDisconnectedException))> _
<FaultContractAttribute(GetType(ServiceNotRunningException))> _
<FaultContractAttribute(GetType(UnknownServiceException))> _
<FaultContractAttribute(GetType(UnknownChannelException))> _
<FaultContractAttribute(GetType(UnauthorizedAccessMonitoringException))> _
<FaultContractAttribute(GetType(UnknownAuthorizationStoreException))> _
<FaultContractAttribute(GetType(UnknownDatabaseException))> _
<FaultContractAttribute(GetType(InvalidDatabaseDataException))> _
Function GetConnectorState ( _
		connectorId As Guid _
) As ConnectorState
C#
[OperationContractAttribute] 
[FaultContractAttribute(typeof(ConnectorInvalidException))] 
[FaultContractAttribute(typeof(TimeoutException))] 
[FaultContractAttribute(typeof(ServerDisconnectedException))] 
[FaultContractAttribute(typeof(ServiceNotRunningException))] 
[FaultContractAttribute(typeof(UnknownServiceException))] 
[FaultContractAttribute(typeof(UnknownChannelException))] 
[FaultContractAttribute(typeof(UnauthorizedAccessMonitoringException))] 
[FaultContractAttribute(typeof(UnknownAuthorizationStoreException))] 
[FaultContractAttribute(typeof(UnknownDatabaseException))] 
[FaultContractAttribute(typeof(InvalidDatabaseDataException))] 
ConnectorState GetConnectorState (
		Guid connectorId
)
C++
[OperationContractAttribute] 
[FaultContractAttribute(typeof(ConnectorInvalidException))] 
[FaultContractAttribute(typeof(TimeoutException))] 
[FaultContractAttribute(typeof(ServerDisconnectedException))] 
[FaultContractAttribute(typeof(ServiceNotRunningException))] 
[FaultContractAttribute(typeof(UnknownServiceException))] 
[FaultContractAttribute(typeof(UnknownChannelException))] 
[FaultContractAttribute(typeof(UnauthorizedAccessMonitoringException))] 
[FaultContractAttribute(typeof(UnknownAuthorizationStoreException))] 
[FaultContractAttribute(typeof(UnknownDatabaseException))] 
[FaultContractAttribute(typeof(InvalidDatabaseDataException))] 
ConnectorState GetConnectorState (
		Guid connectorId
)
J#
/** @attribute OperationContractAttribute() */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.ConnectorInvalidException) */ 
/** @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.UnauthorizedAccessMonitoringException) */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownAuthorizationStoreException) */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownDatabaseException) */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.InvalidDatabaseDataException) */ 
ConnectorState GetConnectorState (
		Guid connectorId
)
JScript
OperationContractAttribute 
FaultContractAttribute(Microsoft.EnterpriseManagement.Common.ConnectorInvalidException) 
FaultContractAttribute(System.TimeoutException) 
FaultContractAttribute(Microsoft.EnterpriseManagement.Common.ServerDisconnectedException) 
FaultContractAttribute(Microsoft.EnterpriseManagement.Common.ServiceNotRunningException) 
FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownServiceException) 
FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownChannelException) 
FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnauthorizedAccessMonitoringException) 
FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownAuthorizationStoreException) 
FaultContractAttribute(Microsoft.EnterpriseManagement.Common.UnknownDatabaseException) 
FaultContractAttribute(Microsoft.EnterpriseManagement.Common.InvalidDatabaseDataException) 
function GetConnectorState (
		connectorId : Guid
) : ConnectorState

Parameters

connectorId

The globally unique identifier (GUID) of the monitoring connector for which the state information is returned.

Return Value

A ConnectorState enumeration that describes the connector's initialization state.

Remarks

The returned value indicates if the monitoring connector is initialized or uninitialized.

The GetConnectorState method is used to check the initialization state of the monitoring connector. The monitoring connector must be set up and initialized before any alerts can be retrieved. 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 ConnectorState to determine if the monitoring connector is already initialized before attempting to Initialize the 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