Share via

IConnectorFramework.UninitializeForTiers Method

  • Article

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Uninitializes the monitoring connector for all tiered Management Groups, which will prohibit getting any alerts when the GetMonitoringAlertsForTiers is called. The failures that occurred for the configured tiers are returned.

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

Usage

'Usage
Dim instance As IConnectorFramework
Dim connectorId As Guid
Dim failures As ConnectorTieredOperationFailure()

instance.UninitializeForTiers(connectorId, failures)

Syntax

'Declaration
<FaultContractAttribute(GetType(TimeoutException))> _
<FaultContractAttribute(GetType(ServiceNotRunningException))> _
<FaultContractAttribute(GetType(UnknownServiceException))> _
<FaultContractAttribute(GetType(UnknownChannelException))> _
<FaultContractAttribute(GetType(UnauthorizedAccessEnterpriseManagementException))> _
<FaultContractAttribute(GetType(UnknownAuthorizationStoreException))> _
<FaultContractAttribute(GetType(UnknownDatabaseException))> _
<FaultContractAttribute(GetType(InvalidDatabaseDataException))> _
<OperationContractAttribute> _
<FaultContractAttribute(GetType(ServerDisconnectedException))> _
Sub UninitializeForTiers ( _
    connectorId As Guid, _
    <OutAttribute> ByRef failures As ConnectorTieredOperationFailure() _
)

[FaultContractAttribute(typeof(TimeoutException))] 
[FaultContractAttribute(typeof(ServiceNotRunningException))] 
[FaultContractAttribute(typeof(UnknownServiceException))] 
[FaultContractAttribute(typeof(UnknownChannelException))] 
[FaultContractAttribute(typeof(UnauthorizedAccessEnterpriseManagementException))] 
[FaultContractAttribute(typeof(UnknownAuthorizationStoreException))] 
[FaultContractAttribute(typeof(UnknownDatabaseException))] 
[FaultContractAttribute(typeof(InvalidDatabaseDataException))] 
[OperationContractAttribute] 
[FaultContractAttribute(typeof(ServerDisconnectedException))] 
void UninitializeForTiers (
    Guid connectorId,
    out ConnectorTieredOperationFailure[] failures
)

[FaultContractAttribute(typeof(TimeoutException))] 
[FaultContractAttribute(typeof(ServiceNotRunningException))] 
[FaultContractAttribute(typeof(UnknownServiceException))] 
[FaultContractAttribute(typeof(UnknownChannelException))] 
[FaultContractAttribute(typeof(UnauthorizedAccessEnterpriseManagementException))] 
[FaultContractAttribute(typeof(UnknownAuthorizationStoreException))] 
[FaultContractAttribute(typeof(UnknownDatabaseException))] 
[FaultContractAttribute(typeof(InvalidDatabaseDataException))] 
[OperationContractAttribute] 
[FaultContractAttribute(typeof(ServerDisconnectedException))] 
void UninitializeForTiers (
    Guid connectorId, 
    [OutAttribute] array<ConnectorTieredOperationFailure^>^% failures
)

/** @attribute FaultContractAttribute(System.TimeoutException) */ 
/** @attribute FaultContractAttribute(Microsoft.EnterpriseManagement.Common.ServiceNotRunningException) */ 
/** @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.ServerDisconnectedException) */ 
void UninitializeForTiers (
    Guid connectorId, 
    /** @attribute OutAttribute() */ /** @ref */ ConnectorTieredOperationFailure[] failures
)

Parameters

  • connectorId
    The globally unique identifier (GUID) for the monitoring connector to uninitialize.
  • failures
    The array of failures that may have occurred for various tiers.

Remarks

After an UninitializeForTiers no data can pass through the monitoring connector. A monitoring connector must be uninitialized before being deleted with the Cleanup method. Attempting to Uninitialize a monitoring connector that is already uninitialized results in an exception with the "The connector is already in the given state." warning.

Perform an UninitializeForTiers before a Cleanup of the monitoring 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 Vista, Windows Server 2003, and

Target Platforms

See Also

Reference

IConnectorFramework Interface
IConnectorFramework Members
Microsoft.EnterpriseManagement.ConnectorFramework Namespace