Added in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Constants](https://developer.android.com/reference/android/telephony/ims/ImsException#constants) \| [Methods](https://developer.android.com/reference/android/telephony/ims/ImsException#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/telephony/ims/ImsException#inhmethods)

# ImsException

*** ** * ** ***

` public final class ImsException `   
` ` ` ` ` extends https://developer.android.com/reference/java/lang/Exception ` ` `

|---|---|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||||
| ↳ | [java.lang.Throwable](https://developer.android.com/reference/java/lang/Throwable) |||
|   | ↳ | [java.lang.Exception](https://developer.android.com/reference/java/lang/Exception) ||
|   |   | ↳ | android.telephony.ims.ImsException |

<br />

*** ** * ** ***

This class defines an IMS-related exception that has been thrown while interacting with a device or carrier provided ImsService implementation.

## Summary

| ### Constants ||
|---|---|
| `int` | `https://developer.android.com/reference/android/telephony/ims/ImsException#CODE_ERROR_INVALID_SUBSCRIPTION` The subscription ID associated with this operation is invalid or not active. |
| `int` | `https://developer.android.com/reference/android/telephony/ims/ImsException#CODE_ERROR_SERVICE_UNAVAILABLE` The operation has failed because there is no remote process available to service it. |
| `int` | `https://developer.android.com/reference/android/telephony/ims/ImsException#CODE_ERROR_UNSPECIFIED` The operation has failed due to an unknown or unspecified error. |
| `int` | `https://developer.android.com/reference/android/telephony/ims/ImsException#CODE_ERROR_UNSUPPORTED_OPERATION` This device or carrier configuration does not support this feature for this subscription. |

| ### Public methods ||
|---|---|
| ` int` | ` https://developer.android.com/reference/android/telephony/ims/ImsException#getCode()() ` |

### Inherited methods

From class ` https://developer.android.com/reference/java/lang/Throwable ` ` final void` ` https://developer.android.com/reference/java/lang/Throwable#addSuppressed(java.lang.Throwable)(https://developer.android.com/reference/java/lang/Throwable exception) `

Appends the specified exception to the exceptions that were suppressed in order to deliver this exception.
` https://developer.android.com/reference/java/lang/Throwable` ` https://developer.android.com/reference/java/lang/Throwable#fillInStackTrace()() `

Fills in the execution stack trace.
` https://developer.android.com/reference/java/lang/Throwable` ` https://developer.android.com/reference/java/lang/Throwable#getCause()() `

Returns the cause of this throwable or `null` if the cause is nonexistent or unknown.
` https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/java/lang/Throwable#getLocalizedMessage()() `

Creates a localized description of this throwable.
` https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/java/lang/Throwable#getMessage()() `

Returns the detail message string of this throwable.
` https://developer.android.com/reference/java/lang/StackTraceElement` ` https://developer.android.com/reference/java/lang/Throwable#getStackTrace()() `

Provides programmatic access to the stack trace information printed by `https://developer.android.com/reference/java/lang/Throwable#printStackTrace()`.
` final https://developer.android.com/reference/java/lang/Throwable` ` https://developer.android.com/reference/java/lang/Throwable#getSuppressed()() `

Returns an array containing all of the exceptions that were suppressed, typically by the `try`-with-resources statement, in order to deliver this exception.
` https://developer.android.com/reference/java/lang/Throwable` ` https://developer.android.com/reference/java/lang/Throwable#initCause(java.lang.Throwable)(https://developer.android.com/reference/java/lang/Throwable cause) `

Initializes the *cause* of this throwable to the specified value.
` void` ` https://developer.android.com/reference/java/lang/Throwable#printStackTrace()() `

Prints this throwable and its backtrace to the standard error stream.
` void` ` https://developer.android.com/reference/java/lang/Throwable#printStackTrace(java.io.PrintWriter)(https://developer.android.com/reference/java/io/PrintWriter s) `

Prints this throwable and its backtrace to the specified print writer.
` void` ` https://developer.android.com/reference/java/lang/Throwable#printStackTrace(java.io.PrintStream)(https://developer.android.com/reference/java/io/PrintStream s) `

Prints this throwable and its backtrace to the specified print stream.
` void` ` https://developer.android.com/reference/java/lang/Throwable#setStackTrace(java.lang.StackTraceElement[])(https://developer.android.com/reference/java/lang/StackTraceElement stackTrace) `

Sets the stack trace elements that will be returned by `https://developer.android.com/reference/java/lang/Throwable#getStackTrace()` and printed by `https://developer.android.com/reference/java/lang/Throwable#printStackTrace()` and related methods.
` https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/java/lang/Throwable#toString()() `

Returns a short description of this throwable.
From class ` https://developer.android.com/reference/java/lang/Object ` ` https://developer.android.com/reference/java/lang/Object` ` https://developer.android.com/reference/java/lang/Object#clone()() `

Creates and returns a copy of this object.
` boolean` ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) `

Indicates whether some other object is "equal to" this one.
` void` ` https://developer.android.com/reference/java/lang/Object#finalize()() `

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
` final https://developer.android.com/reference/java/lang/Class<?>` ` https://developer.android.com/reference/java/lang/Object#getClass()() `

Returns the runtime class of this `Object`.
` int` ` https://developer.android.com/reference/java/lang/Object#hashCode()() `

Returns a hash code value for the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#notify()() `

Wakes up a single thread that is waiting on this object's monitor.
` final void` ` https://developer.android.com/reference/java/lang/Object#notifyAll()() `

Wakes up all threads that are waiting on this object's monitor.
` https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/java/lang/Object#toString()() `

Returns a string representation of the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos) `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis) `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait()() `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*.

## Constants

### CODE_ERROR_INVALID_SUBSCRIPTION

Added in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public static final int CODE_ERROR_INVALID_SUBSCRIPTION
```

The subscription ID associated with this operation is invalid or not active.

This is a configuration error and there should be no retry. The subscription used for this operation is either invalid or has become inactive. The active subscriptions can be queried with `https://developer.android.com/reference/android/telephony/SubscriptionManager#getActiveSubscriptionInfoList()`.

<br />

Constant Value: 3 (0x00000003)

### CODE_ERROR_SERVICE_UNAVAILABLE

Added in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public static final int CODE_ERROR_SERVICE_UNAVAILABLE
```

The operation has failed because there is no remote process available to service it. This may be due to a process crash or other illegal state.

This is a temporary error and the operation may be retried until the connection to the remote process is restored.

<br />

Constant Value: 1 (0x00000001)

### CODE_ERROR_UNSPECIFIED

Added in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public static final int CODE_ERROR_UNSPECIFIED
```

The operation has failed due to an unknown or unspecified error.

<br />

Constant Value: 0 (0x00000000)

### CODE_ERROR_UNSUPPORTED_OPERATION

Added in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public static final int CODE_ERROR_UNSUPPORTED_OPERATION
```

This device or carrier configuration does not support this feature for this subscription.

This is a permanent configuration error and there should be no retry until the subscription changes if this operation is denied due to a carrier configuration. If this is due to a device configuration, the feature `https://developer.android.com/reference/android/content/pm/PackageManager#FEATURE_TELEPHONY_IMS` is not available or the device has no ImsService implementation to service this request.

<br />

Constant Value: 2 (0x00000002)

## Public methods

### getCode

Added in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public int getCode ()
```

<br />

<br />

| Returns ||
|---|---|
| `int` | the IMS Error code that is associated with this `https://developer.android.com/reference/android/telephony/ims/ImsException`. Value is one of the following: - `https://developer.android.com/reference/android/telephony/ims/ImsException#CODE_ERROR_UNSPECIFIED` - `https://developer.android.com/reference/android/telephony/ims/ImsException#CODE_ERROR_SERVICE_UNAVAILABLE` - `https://developer.android.com/reference/android/telephony/ims/ImsException#CODE_ERROR_UNSUPPORTED_OPERATION` - `https://developer.android.com/reference/android/telephony/ims/ImsException#CODE_ERROR_INVALID_SUBSCRIPTION` |