Merge "Document AccountManager method failures for locked user."

package android.accounts;

import static android.Manifest.permission.GET_ACCOUNTS;

import android.annotation.BroadcastBehavior;

import android.annotation.IntDef;

import android.annotation.NonNull;

import android.annotation.RequiresPermission;

import android.annotation.SdkConstant;

import android.annotation.SdkConstant.SdkConstantType;

import android.annotation.Size;

import android.annotation.SystemApi;

import android.annotation.SystemService;

import android.annotation.SdkConstant.SdkConstantType;

import android.annotation.BroadcastBehavior;

import android.annotation.UnsupportedAppUsage;

import android.app.Activity;

import android.content.BroadcastReceiver;

import android.content.IntentFilter;

import android.content.IntentSender;

import android.content.res.Resources;

import android.content.pm.ApplicationInfo;

import android.content.pm.PackageManager;

import android.database.SQLException;

import android.os.Build;

import android.os.Bundle;

import android.os.Handler;

import android.os.Looper;

import android.os.Parcelable;

import android.os.Process;

import android.os.RemoteException;

import android.os.UserHandle;

import android.text.TextUtils;

import android.util.Log;

import com.android.internal.R;

import com.google.android.collect.Maps;

import java.io.IOException;

import java.lang.annotation.Retention;

import java.lang.annotation.RetentionPolicy;

import java.lang.SuppressWarnings;

import java.util.ArrayList;

import java.util.Arrays;

import java.util.HashMap;

     * {@link android.os.Build.VERSION_CODES#LOLLIPOP_MR1}.

     *

     * @param account The account to query for user data

     * @return The user data, null if the account or key doesn't exist

     * @return The user data, null if the account, key doesn't exist, or the user is locked

     */

    public String getUserData(final Account account, final String key) {

        if (account == null) throw new IllegalArgumentException("account is null");

     * @param userdata String values to use for the account's userdata, null for

     *            none

     * @return True if the account was successfully added, false if the account

     *         already exists, the account is null, or another error occurs.

     *         already exists, the account is null, the user is locked, or another error occurs.

     */

    public boolean addAccountExplicitly(Account account, String password, Bundle userdata) {

        if (account == null) throw new IllegalArgumentException("account is null");

     * @param account The account for which an auth token is to be fetched. Cannot be {@code null}.

     * @param authTokenType The type of auth token to fetch. Cannot be {@code null}.

     * @return The cached auth token for this account and type, or null if

     *     no auth token is cached or the account does not exist.

     *     no auth token is cached, the account does not exist, or the user is locked

     * @see #getAuthToken

     */

    public String peekAuthToken(final Account account, final String authTokenType) {

    }

    /**

     * Asks the user to enter a new password for an account but not updating the

     * Asks the user to enter a new password for the account but not updating the

     * saved credentials for the account until {@link #finishSession} is called.

     * <p>

     * This method may be called from any thread, but the returned