IConnectorFramework.GetMonitoringAlertsWithBatchSizeForTiers(Guid, String, Int32, ConnectorTieredOperationFailure[]) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets alerts for the given connector.
public:
cli::array <Microsoft::EnterpriseManagement::ConnectorFramework::ConnectorMonitoringAlert ^> ^ GetMonitoringAlertsWithBatchSizeForTiers(Guid connectorId, System::String ^ languageCodes, int batchSize, [Runtime::InteropServices::Out] cli::array <Microsoft::EnterpriseManagement::ConnectorFramework::ConnectorTieredOperationFailure ^> ^ % failures);
[System.ServiceModel.FaultContract(typeof(System.ArgumentNullException))]
[System.ServiceModel.FaultContract(typeof(Microsoft.EnterpriseManagement.Common.UnknownChannelException))]
[System.ServiceModel.FaultContract(typeof(Microsoft.EnterpriseManagement.Common.ObjectNotFoundException))]
[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.ConnectorInvalidException))]
[System.ServiceModel.FaultContract(typeof(System.InvalidOperationException))]
[System.ServiceModel.FaultContract(typeof(Microsoft.EnterpriseManagement.Common.UnauthorizedAccessEnterpriseManagementException))]
[System.ServiceModel.FaultContract(typeof(System.TimeoutException))]
[System.ServiceModel.FaultContract(typeof(Microsoft.EnterpriseManagement.Common.ServerDisconnectedException))]
[System.ServiceModel.FaultContract(typeof(Microsoft.EnterpriseManagement.Common.ServiceNotRunningException))]
[System.ServiceModel.FaultContract(typeof(Microsoft.EnterpriseManagement.Common.UnknownServiceException))]
[System.ServiceModel.OperationContract]
public Microsoft.EnterpriseManagement.ConnectorFramework.ConnectorMonitoringAlert[] GetMonitoringAlertsWithBatchSizeForTiers (Guid connectorId, string languageCodes, int batchSize, out Microsoft.EnterpriseManagement.ConnectorFramework.ConnectorTieredOperationFailure[] failures);
abstract member GetMonitoringAlertsWithBatchSizeForTiers : Guid * string * int * ConnectorTieredOperationFailure[] -> Microsoft.EnterpriseManagement.ConnectorFramework.ConnectorMonitoringAlert[]
Public Function GetMonitoringAlertsWithBatchSizeForTiers (connectorId As Guid, languageCodes As String, batchSize As Integer, ByRef failures As ConnectorTieredOperationFailure()) As ConnectorMonitoringAlert()
Parameters
- connectorId
- Guid
The connector id.
- languageCodes
- String
A comma delimited list of three letter iso language standard language codes.
- batchSize
- Int32
The batch size.
- failures
- ConnectorTieredOperationFailure[]
Any failures that occurred for various tiers.
Returns
The alerts that have changed since the current bookmark of the connector.
- Attributes
Remarks
This method will only retrieve up to the number of alerts that are specified by the batchSize parameter. This limitation allows you to perform the get monitoring alerts operation in small batches, thereby avoiding a time-out failure. The batchSize is the total across all tiers, not per tier.
It is good practice to limit the number of alerts obtained by a single call. When you perform this GetMonitoringAlertsWithBatchSizeForTiers method you should check to see if the count property of the returned collection equals or exceeds the batchSize. If the count property of the returned collection equals or exceeds the batchSize then you should acknowledge the alerts received, and call this function again to get the next batch of alerts. Only when the returned collection is smaller than the batchSize can you be sure that you have received all of the alerts.
This method gets alerts only from the bookmark date to the current time less 30 seconds.
After you get the monitoring alert, you need to acknowledge that alert with an AcknowledgeMonitoringAlertsForTiers. Failure to acknowledge an alert will result in subsequent calls to get new alerts returning the already received alerts.