Unified Communications Managed API 2.0 Core SDK follows the standard .NET Framework exception model for reporting exceptions. Both the standard exception classes in the .NET Framework and custom exception classes specific to UCMA 2.0 Core SDK are used. UCMA 2.0 Core SDK applications should catch exceptions thrown by UCMA 2.0 Core SDK methods. In addition we recommend that applications validate the data they pass to the API to avoid exceptions derived from ArgumentExceptionfrom being thrown in released products.
Standard .NET Framework Exception
Classes
The following standard exception classes are adopted by UCMA 2.0 Core SDK.
- ArgumentException
-
Thrown when an invalid argument is passed to a method call or an invalid value is set on a property.
- ArgumentNullException
-
Thrown when a nullargument value is passed as a parameter that cannot be null. Also thrown for properties that cannot be set to null.
- ArgumentOutOfRangeException
-
Thrown when a parameter passed to a method call is not within the required range. Also thrown for properties that cannot be set to null.
- InvalidOperationException
-
Thrown when the current object state is not valid for a particular action. For example, a user tried to send a message on a terminated IM session.
Exception Classes Specific to
UCMA 2.0
The following custom exception classes are implemented in UCMA 2.0 Core SDK.
- RealTimeException
-
Except for RealTimeInvalidOperationException, this is the root class for the exceptions that are specific to UCMA V1.0 and UCMA 2.0 Core SDK. It is thrown when the error condition cannot be mapped to any other exception types.
- ConferenceFailureException
-
Thrown when an error associated with conference scheduling or management occurred when communicating with the server. Possible reasons for this exception being thrown include the following:
- The conference could not be created, scheduled, retrieved, or
removed.
- The conference could not have its settings modified.
- The check failed for whether a passcode is optional for a
conference.
- The conference passcode could not be verified.
- A failure occurred in the attempt to get the available MCU
types for a conference.
Note:Failure to communicate with the server components for conferencing could result in FailureResponseException. - The conference could not be created, scheduled, retrieved, or
removed.
- ConnectionFailureException
-
Thrown when a network connection could not be made. Applications might consider prompting for a new URI (host and port) or a server name.
- FailureResponseException
-
Thrown when a 4xx, 5xx, or 6xx response was received for a request. This exception contains the ResponseDataproperty, which contains the complete response including response code, reason text, headers, and message body. In some rare cases, this may also be thrown when an error other than a 4xx, 5xx, or 6xx response occurred. In such cases the ResponseDataproperty is null.
- AuthenticationException
-
Thrown when a 401 response was received in authentication. It exposes the failed response data ( ResponseData) and parsed values of authentication-specific headers.
- PublishSubscribeException
-
Thrown when a FailureResponseExceptionoccurred for requests of the SERVICE and SUBSCRIBE types. This class inherits from FailureResponseExceptionand adds diagnostic information about the message body and the fault code parsed from the body.
- RegisterException
-
Thrown when an error occurred in a registration-related operation.
- ServerPolicyException
-
Thrown when an operation is rejected due to server policy.
- MessageParsingException
-
Thrown when an incoming response or message could not be parsed. For example, an invalid custom signaling header was used.
- MultipartBodyParserException
-
Thorwn when a parsing error occurs during multipart body parsing.
- OfferAnswerException
-
Thrown when one of the following errors occurred in a media provider:
- The SDP for the offer could not be created.
- The answer received from the remote side could not be accepted.
- A collision in the offer/answer interchange occurred because a
previous negotiation is still pending.
- An answer for a received offer could not be sent.
- The SDP for the offer could not be created.
- OperationFailureException
-
Thrown when an operation fails. The FailureReasonproperty indicates the cause of failure.
- OperationTimeoutException
-
Thrown when an operation could not be completed in a reasonable time. For example, a response from another endpoint or server was not received after a request was sent.
- TlsFailureException
-
Thrown when an error occurred during a TLS handshake. This error can occur when the remote server certificate is rejected. This can also occur when the MTLS local certificate is rejected by the remote server.
- RealTimeInvalidOperationException
-
Thrown when the operation is currently invalid, but the application might be able to take further action based on the reason.
The following object model lists the exceptions that are specific to UCMA 2.0 Core SDK.
