AuthenticationRequiredException
  public
  
  final
  
  class
  AuthenticationRequiredException
  
  
  
  
  
  
  
  
  
  
  
  
  
    extends SecurityException
  
  
  
  
  
      implements
      
        Parcelable
      
  
  
| java.lang.Object | |||||
| ↳ | java.lang.Throwable | ||||
| ↳ | java.lang.Exception | ||||
| ↳ | java.lang.RuntimeException | ||||
| ↳ | java.lang.SecurityException | ||||
| ↳ | android.app.AuthenticationRequiredException | ||||
Specialization of SecurityException that is thrown when authentication is needed from the
 end user before viewing the content.
 
This exception is only appropriate where there is a concrete action the user can take to authorize and make forward progress, such as confirming or entering authentication credentials, or granting access via other means.
 Note: legacy code that receives this exception may treat it as a general
 SecurityException, and thus there is no guarantee that the action contained will be
 invoked by the user.
 
Summary
| Inherited constants | 
|---|
| Fields | |
|---|---|
| 
    public
    static
    final
    Creator<AuthenticationRequiredException> | CREATOR
 | 
| Public constructors | |
|---|---|
| 
      AuthenticationRequiredException(Throwable cause, PendingIntent userAction)
      Create an instance ready to be thrown. | |
| Public methods | |
|---|---|
| 
        
        
        
        
        
        int | 
      describeContents()
      Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. | 
| 
        
        
        
        
        
        PendingIntent | 
      getUserAction()
      Return primary action that will initiate the authorization. | 
| 
        
        
        
        
        
        void | 
      writeToParcel(Parcel dest, int flags)
      Flatten this object in to a Parcel. | 
| Inherited methods | |
|---|---|
Fields
Public constructors
AuthenticationRequiredException
public AuthenticationRequiredException (Throwable cause, PendingIntent userAction)
Create an instance ready to be thrown.
| Parameters | |
|---|---|
| cause | Throwable: original cause with details designed for engineering
            audiences. | 
| userAction | PendingIntent: primary action that will initiate the recovery. This
            must launch an activity that is expected to setActivity.setResult(int)before finishing to
            communicate the final status of the recovery. For example,
            apps that observeActivity.RESULT_OKmay choose to
            immediately retry their operation. | 
Public methods
describeContents
public int describeContents ()
Describe the kinds of special objects contained in this Parcelable
 instance's marshaled representation. For example, if the object will
 include a file descriptor in the output of writeToParcel(android.os.Parcel, int),
 the return value of this method must include the
 CONTENTS_FILE_DESCRIPTOR bit.
| Returns | |
|---|---|
| int | a bitmask indicating the set of special object types marshaled
 by this Parcelable object instance.
 Value is either 0orCONTENTS_FILE_DESCRIPTOR | 
getUserAction
public PendingIntent getUserAction ()
Return primary action that will initiate the authorization.
| Returns | |
|---|---|
| PendingIntent | |
writeToParcel
public void writeToParcel (Parcel dest, int flags)
Flatten this object in to a Parcel.
| Parameters | |
|---|---|
| dest | Parcel: The Parcel in which the object should be written.
 This value cannot benull. | 
| flags | int: Additional flags about how the object should be written.
 May be 0 orParcelable.PARCELABLE_WRITE_RETURN_VALUE.
 Value is either0or a combination ofParcelable.PARCELABLE_WRITE_RETURN_VALUE, and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES | 
