Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in[Ad Services Extensions 4](https://developer.android.com/sdkExtensions)  
Summary:[Ctors](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/RequestSurfacePackageException#pubctors)\|[Methods](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/RequestSurfacePackageException#pubmethods)\|[Inherited Methods](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/RequestSurfacePackageException#inhmethods)  

# RequestSurfacePackageException

`
public

final

class
RequestSurfacePackageException
`  
`


``


``

extends `[Exception](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.app.sdksandbox.RequestSurfacePackageException |

<br />

*** ** * ** ***

Exception thrown by[SdkSandboxManager#requestSurfacePackage](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/SdkSandboxManager#requestSurfacePackage(java.lang.String,%20android.os.Bundle,%20java.util.concurrent.Executor,%20android.os.OutcomeReceiver<android.os.Bundle,android.app.sdksandbox.RequestSurfacePackageException>))

## Summary

|                                                                                                                                                                                                                                                                                                                                                                                 ### Public constructors                                                                                                                                                                                                                                                                                                                                                                                 ||
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| ` `[RequestSurfacePackageException](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/RequestSurfacePackageException#RequestSurfacePackageException(int,%20java.lang.String))`(int requestSurfacePackageErrorCode, `[String](https://developer.android.com/reference/java/lang/String)` message) ` Initializes a[RequestSurfacePackageException](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/RequestSurfacePackageException)with a result code and a message                                                                                                                                                                                                                                             |
| ` `[RequestSurfacePackageException](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/RequestSurfacePackageException#RequestSurfacePackageException(int,%20java.lang.String,%20java.lang.Throwable))`(int requestSurfacePackageErrorCode, `[String](https://developer.android.com/reference/java/lang/String)` message, `[Throwable](https://developer.android.com/reference/java/lang/Throwable)` cause) ` Initializes a[RequestSurfacePackageException](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/RequestSurfacePackageException)with a result code, a message and a cause.                                                                                                                          |
| ` `[RequestSurfacePackageException](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/RequestSurfacePackageException#RequestSurfacePackageException(int,%20java.lang.String,%20java.lang.Throwable,%20android.os.Bundle))`(int requestSurfacePackageErrorCode, `[String](https://developer.android.com/reference/java/lang/String)` message, `[Throwable](https://developer.android.com/reference/java/lang/Throwable)` cause, `[Bundle](https://developer.android.com/reference/android/os/Bundle)` extraInfo) ` Initializes a[RequestSurfacePackageException](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/RequestSurfacePackageException)with a result code, a message, a cause and extra information. |

|                                                                                                                                                            ### Public methods                                                                                                                                                             ||
|------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` `[Bundle](https://developer.android.com/reference/android/os/Bundle) | ` `[getExtraErrorInformation](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/RequestSurfacePackageException#getExtraErrorInformation())`() ` Returns the extra error information this exception was constructed with.       |
| ` int`                                                                 | ` `[getRequestSurfacePackageErrorCode](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/RequestSurfacePackageException#getRequestSurfacePackageErrorCode())`() ` Returns the result code this exception was constructed with. |

| ### Inherited methods |
|-----------------------|---|
| From class` `[java.lang.Throwable](https://developer.android.com/reference/java/lang/Throwable)` ` |-----------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` final void`                                                                                 | ` `[addSuppressed](https://developer.android.com/reference/java/lang/Throwable#addSuppressed(java.lang.Throwable))`(`[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.                                                                                                                                                                                                            | | ` `[Throwable](https://developer.android.com/reference/java/lang/Throwable)                   | ` `[fillInStackTrace](https://developer.android.com/reference/java/lang/Throwable#fillInStackTrace())`() ` Fills in the execution stack trace.                                                                                                                                                                                                                                                                                                                                                                                    | | ` `[Throwable](https://developer.android.com/reference/java/lang/Throwable)                   | ` `[getCause](https://developer.android.com/reference/java/lang/Throwable#getCause())`() ` Returns the cause of this throwable or`null`if the cause is nonexistent or unknown.                                                                                                                                                                                                                                                                                                                                                    | | ` `[String](https://developer.android.com/reference/java/lang/String)                         | ` `[getLocalizedMessage](https://developer.android.com/reference/java/lang/Throwable#getLocalizedMessage())`() ` Creates a localized description of this throwable.                                                                                                                                                                                                                                                                                                                                                               | | ` `[String](https://developer.android.com/reference/java/lang/String)                         | ` `[getMessage](https://developer.android.com/reference/java/lang/Throwable#getMessage())`() ` Returns the detail message string of this throwable.                                                                                                                                                                                                                                                                                                                                                                               | | ` `[StackTraceElement[]](https://developer.android.com/reference/java/lang/StackTraceElement) | ` `[getStackTrace](https://developer.android.com/reference/java/lang/Throwable#getStackTrace())`() ` Provides programmatic access to the stack trace information printed by[printStackTrace()](https://developer.android.com/reference/java/lang/Throwable#printStackTrace()).                                                                                                                                                                                                                                                    | | ` final `[Throwable[]](https://developer.android.com/reference/java/lang/Throwable)           | ` `[getSuppressed](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.                                                                                                                                                                                                                                                                  | | ` `[Throwable](https://developer.android.com/reference/java/lang/Throwable)                   | ` `[initCause](https://developer.android.com/reference/java/lang/Throwable#initCause(java.lang.Throwable))`(`[Throwable](https://developer.android.com/reference/java/lang/Throwable)` cause) ` Initializes the*cause*of this throwable to the specified value.                                                                                                                                                                                                                                                                   | | ` void`                                                                                       | ` `[printStackTrace](https://developer.android.com/reference/java/lang/Throwable#printStackTrace())`() ` Prints this throwable and its backtrace to the standard error stream.                                                                                                                                                                                                                                                                                                                                                    | | ` void`                                                                                       | ` `[printStackTrace](https://developer.android.com/reference/java/lang/Throwable#printStackTrace(java.io.PrintWriter))`(`[PrintWriter](https://developer.android.com/reference/java/io/PrintWriter)` s) ` Prints this throwable and its backtrace to the specified print writer.                                                                                                                                                                                                                                                  | | ` void`                                                                                       | ` `[printStackTrace](https://developer.android.com/reference/java/lang/Throwable#printStackTrace(java.io.PrintStream))`(`[PrintStream](https://developer.android.com/reference/java/io/PrintStream)` s) ` Prints this throwable and its backtrace to the specified print stream.                                                                                                                                                                                                                                                  | | ` void`                                                                                       | ` `[setStackTrace](https://developer.android.com/reference/java/lang/Throwable#setStackTrace(java.lang.StackTraceElement[]))`(`[StackTraceElement[]](https://developer.android.com/reference/java/lang/StackTraceElement)` stackTrace) ` Sets the stack trace elements that will be returned by[getStackTrace()](https://developer.android.com/reference/java/lang/Throwable#getStackTrace())and printed by[printStackTrace()](https://developer.android.com/reference/java/lang/Throwable#printStackTrace())and related methods. | | ` `[String](https://developer.android.com/reference/java/lang/String)                         | ` `[toString](https://developer.android.com/reference/java/lang/Throwable#toString())`() ` Returns a short description of this throwable.                                                                                                                                                                                                                                                                                                                                                                                         | ||
| From class` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object)` ` |--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object)          | ` `[clone](https://developer.android.com/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object.                                                                                                                                                      | | ` boolean`                                                                     | ` `[equals](https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](https://developer.android.com/reference/java/lang/Object)` obj) ` Indicates whether some other object is "equal to" this one.                                           | | ` void`                                                                        | ` `[finalize](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 `[Class](https://developer.android.com/reference/java/lang/Class)`<?>` | ` `[getClass](https://developer.android.com/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this`Object`.                                                                                                                                                | | ` int`                                                                         | ` `[hashCode](https://developer.android.com/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object.                                                                                                                                                 | | ` final void`                                                                  | ` `[notify](https://developer.android.com/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor.                                                                                                                            | | ` final void`                                                                  | ` `[notifyAll](https://developer.android.com/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor.                                                                                                                         | | ` `[String](https://developer.android.com/reference/java/lang/String)          | ` `[toString](https://developer.android.com/reference/java/lang/Object#toString())`() ` Returns a string representation of the object.                                                                                                                                            | | ` final void`                                                                  | ` `[wait](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`                                                                  | ` `[wait](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`                                                                  | ` `[wait](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*.                                                                                             | ||

## Public constructors

### RequestSurfacePackageException

Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in[Ad Services Extensions 4](https://developer.android.com/sdkExtensions)  

```
public RequestSurfacePackageException (int requestSurfacePackageErrorCode, 
                String message)
```

Initializes a[RequestSurfacePackageException](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/RequestSurfacePackageException)with a result code and a message

<br />

|                                                                                                                                                                                                                                           Parameters                                                                                                                                                                                                                                            ||
|----------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `requestSurfacePackageErrorCode` | `int`: The result code. Value is[SdkSandboxManager.REQUEST_SURFACE_PACKAGE_INTERNAL_ERROR](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/SdkSandboxManager#REQUEST_SURFACE_PACKAGE_INTERNAL_ERROR), or[SdkSandboxManager.REQUEST_SURFACE_PACKAGE_SDK_NOT_LOADED](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/SdkSandboxManager#REQUEST_SURFACE_PACKAGE_SDK_NOT_LOADED) <br /> |
| `message`                        | `String`: The detailed message which is saved for later retrieval by the[Throwable.getMessage()](https://developer.android.com/reference/java/lang/Throwable#getMessage())method. This value may be`null`. <br />                                                                                                                                                                                                                                             |

### RequestSurfacePackageException

Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in[Ad Services Extensions 4](https://developer.android.com/sdkExtensions)  

```
public RequestSurfacePackageException (int requestSurfacePackageErrorCode, 
                String message, 
                Throwable cause)
```

Initializes a[RequestSurfacePackageException](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/RequestSurfacePackageException)with a result code, a message and a cause.

<br />

|                                                                                                                                                                                                                                           Parameters                                                                                                                                                                                                                                            ||
|----------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `requestSurfacePackageErrorCode` | `int`: The result code. Value is[SdkSandboxManager.REQUEST_SURFACE_PACKAGE_INTERNAL_ERROR](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/SdkSandboxManager#REQUEST_SURFACE_PACKAGE_INTERNAL_ERROR), or[SdkSandboxManager.REQUEST_SURFACE_PACKAGE_SDK_NOT_LOADED](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/SdkSandboxManager#REQUEST_SURFACE_PACKAGE_SDK_NOT_LOADED) <br /> |
| `message`                        | `String`: The detailed message which is saved for later retrieval by the[Throwable.getMessage()](https://developer.android.com/reference/java/lang/Throwable#getMessage())method. This value may be`null`. <br />                                                                                                                                                                                                                                             |
| `cause`                          | `Throwable`: The cause of the exception, which is saved for later retrieval by the[Throwable.getCause()](https://developer.android.com/reference/java/lang/Throwable#getCause())method. A null value is permitted, and indicates that the cause is nonexistent or unknown. <br />                                                                                                                                                                             |

### RequestSurfacePackageException

Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in[Ad Services Extensions 4](https://developer.android.com/sdkExtensions)  

```
public RequestSurfacePackageException (int requestSurfacePackageErrorCode, 
                String message, 
                Throwable cause, 
                Bundle extraInfo)
```

Initializes a[RequestSurfacePackageException](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/RequestSurfacePackageException)with a result code, a message, a cause and extra information.

<br />

|                                                                                                                                                                                                                                           Parameters                                                                                                                                                                                                                                            ||
|----------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `requestSurfacePackageErrorCode` | `int`: The result code. Value is[SdkSandboxManager.REQUEST_SURFACE_PACKAGE_INTERNAL_ERROR](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/SdkSandboxManager#REQUEST_SURFACE_PACKAGE_INTERNAL_ERROR), or[SdkSandboxManager.REQUEST_SURFACE_PACKAGE_SDK_NOT_LOADED](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/SdkSandboxManager#REQUEST_SURFACE_PACKAGE_SDK_NOT_LOADED) <br /> |
| `message`                        | `String`: The detailed message which is saved for later retrieval by the[Throwable.getMessage()](https://developer.android.com/reference/java/lang/Throwable#getMessage())method. This value may be`null`. <br />                                                                                                                                                                                                                                             |
| `cause`                          | `Throwable`: The cause of the exception, which is saved for later retrieval by the[Throwable.getCause()](https://developer.android.com/reference/java/lang/Throwable#getCause())method. A null value is permitted, and indicates that the cause is nonexistent or unknown. <br />                                                                                                                                                                             |
| `extraInfo`                      | `Bundle`: Extra error information. This is empty if there is no such information. This value cannot be`null`. <br />                                                                                                                                                                                                                                                                                                                                          |

## Public methods

### getExtraErrorInformation

Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in[Ad Services Extensions 4](https://developer.android.com/sdkExtensions)  

```
public Bundle getExtraErrorInformation ()
```

Returns the extra error information this exception was constructed with.

<br />

|                                                                   Returns                                                                   ||
|---------------------------------------------------------------------|------------------------------------------------------------------------|
| [Bundle](https://developer.android.com/reference/android/os/Bundle) | The extra error information Bundle. This value cannot be`null`. <br /> |

### getRequestSurfacePackageErrorCode

Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in[Ad Services Extensions 4](https://developer.android.com/sdkExtensions)  

```
public int getRequestSurfacePackageErrorCode ()
```

Returns the result code this exception was constructed with.

<br />

|                                                                                                                                                                                                                                                                                                                                                                                                        Returns                                                                                                                                                                                                                                                                                                                                                                                                         ||
|-------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `int` | The result code from[SdkSandboxManager#requestSurfacePackage](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/SdkSandboxManager#requestSurfacePackage(java.lang.String,%20android.os.Bundle,%20java.util.concurrent.Executor,%20android.os.OutcomeReceiver<android.os.Bundle,android.app.sdksandbox.RequestSurfacePackageException>))Value is[SdkSandboxManager.REQUEST_SURFACE_PACKAGE_INTERNAL_ERROR](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/SdkSandboxManager#REQUEST_SURFACE_PACKAGE_INTERNAL_ERROR), or[SdkSandboxManager.REQUEST_SURFACE_PACKAGE_SDK_NOT_LOADED](https://developer.android.com/design-for-safety/privacy-sandbox/reference/sdksandbox/SdkSandboxManager#REQUEST_SURFACE_PACKAGE_SDK_NOT_LOADED) <br /> |