ImsException

Kotlin |Java

public final class ImsException
extends Exception

java.lang.Object
↳	java.lang.Throwable
	↳	java.lang.Exception
		↳	android.telephony.ims.ImsException

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

Summary

Constants
`int`	`CODE_ERROR_INVALID_SUBSCRIPTION` The subscription ID associated with this operation is invalid or not active.
`int`	`CODE_ERROR_SERVICE_UNAVAILABLE` The operation has failed because there is no remote process available to service it.
`int`	`CODE_ERROR_UNSPECIFIED` The operation has failed due to an unknown or unspecified error.
`int`	`CODE_ERROR_UNSUPPORTED_OPERATION` This device or carrier configuration does not support this feature for this subscription.

Public methods
`int`	`getCode()`

Inherited methods

From class


        
          java.lang.Throwable

`final void`	`addSuppressed(Throwable exception)` Appends the specified exception to the exceptions that were suppressed in order to deliver this exception.
`Throwable`	`fillInStackTrace()` Fills in the execution stack trace.
`Throwable`	`getCause()` Returns the cause of this throwable or `null` if the cause is nonexistent or unknown.
`String`	`getLocalizedMessage()` Creates a localized description of this throwable.
`String`	`getMessage()` Returns the detail message string of this throwable.
`StackTraceElement[]`	`getStackTrace()` Provides programmatic access to the stack trace information printed by `printStackTrace()`.
`final 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.
`Throwable`	`initCause(Throwable cause)` Initializes the cause of this throwable to the specified value.
`void`	`printStackTrace()` Prints this throwable and its backtrace to the standard error stream.
`void`	`printStackTrace(PrintWriter s)` Prints this throwable and its backtrace to the specified print writer.
`void`	`printStackTrace(PrintStream s)` Prints this throwable and its backtrace to the specified print stream.
`void`	`setStackTrace(StackTraceElement[] stackTrace)` Sets the stack trace elements that will be returned by `getStackTrace()` and printed by `printStackTrace()` and related methods.
`String`	`toString()` Returns a short description of this throwable.

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(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`	`wait(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`	`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

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 SubscriptionManager.getActiveSubscriptionInfoList().

Constant Value: 3 (0x00000003)

CODE_ERROR_SERVICE_UNAVAILABLE

Added in API level 30

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.

Constant Value: 1 (0x00000001)

CODE_ERROR_UNSPECIFIED

Added in API level 30

public static final int CODE_ERROR_UNSPECIFIED

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

Constant Value: 0 (0x00000000)

CODE_ERROR_UNSUPPORTED_OPERATION

Added in API level 30

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 PackageManager.FEATURE_TELEPHONY_IMS is not available or the device has no ImsService implementation to service this request.

Constant Value: 2 (0x00000002)

Public methods

getCode

Added in API level 30

public int getCode ()

Returns
`int`	the IMS Error code that is associated with this `ImsException`. Value is `CODE_ERROR_UNSPECIFIED`, `CODE_ERROR_SERVICE_UNAVAILABLE`, `CODE_ERROR_UNSUPPORTED_OPERATION`, or `CODE_ERROR_INVALID_SUBSCRIPTION`