AccountManager.GetAuthToken Methode

Definition

Namespace:: Android.Accounts

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

Name	Beschreibung
GetAuthToken(Account, String, Boolean, IAccountManagerCallback, Handler)	Veraltet. Ruft ein Authentifizierungstoken des angegebenen Typs für ein bestimmtes Konto ab, optional wird eine Benachrichtigung ausgelöst, wenn der Benutzer Anmeldeinformationen eingeben muss.
GetAuthToken(Account, String, Bundle, Activity, IAccountManagerCallback, Handler)	Ruft ein Authentifizierungstoken des angegebenen Typs für ein bestimmtes Konto ab und fordert den Benutzer bei Bedarf zur Eingabe von Anmeldeinformationen auf.
GetAuthToken(Account, String, Bundle, Boolean, IAccountManagerCallback, Handler)	Ruft ein Authentifizierungstoken des angegebenen Typs für ein bestimmtes Konto ab, optional wird eine Benachrichtigung ausgelöst, wenn der Benutzer Anmeldeinformationen eingeben muss.

GetAuthToken(Account, String, Boolean, IAccountManagerCallback, Handler)

Achtung

deprecated

Ruft ein Authentifizierungstoken des angegebenen Typs für ein bestimmtes Konto ab, optional wird eine Benachrichtigung ausgelöst, wenn der Benutzer Anmeldeinformationen eingeben muss.

[Android.Runtime.Register("getAuthToken", "(Landroid/accounts/Account;Ljava/lang/String;ZLandroid/accounts/AccountManagerCallback;Landroid/os/Handler;)Landroid/accounts/AccountManagerFuture;", "GetGetAuthToken_Landroid_accounts_Account_Ljava_lang_String_ZLandroid_accounts_AccountManagerCallback_Landroid_os_Handler_Handler")]
[Android.Runtime.RequiresPermission("android.permission.USE_CREDENTIALS")]
[System.Obsolete("deprecated")]
public virtual Android.Accounts.IAccountManagerFuture? GetAuthToken(Android.Accounts.Account? account, string? authTokenType, bool notifyAuthFailure, Android.Accounts.IAccountManagerCallback? callback, Android.OS.Handler? handler);

[<Android.Runtime.Register("getAuthToken", "(Landroid/accounts/Account;Ljava/lang/String;ZLandroid/accounts/AccountManagerCallback;Landroid/os/Handler;)Landroid/accounts/AccountManagerFuture;", "GetGetAuthToken_Landroid_accounts_Account_Ljava_lang_String_ZLandroid_accounts_AccountManagerCallback_Landroid_os_Handler_Handler")>]
[<Android.Runtime.RequiresPermission("android.permission.USE_CREDENTIALS")>]
[<System.Obsolete("deprecated")>]
abstract member GetAuthToken : Android.Accounts.Account * string * bool * Android.Accounts.IAccountManagerCallback * Android.OS.Handler -> Android.Accounts.IAccountManagerFuture
override this.GetAuthToken : Android.Accounts.Account * string * bool * Android.Accounts.IAccountManagerCallback * Android.OS.Handler -> Android.Accounts.IAccountManagerFuture

Parameter

account: Account

Das Konto zum Abrufen eines Authentifizierungstokens für

authTokenType: String

Der Authentifizierungstokentyp, ein Authentifikator-abhängiges Zeichenfolgentoken, darf nicht null sein.

notifyAuthFailure: Boolean

True, um eine Benachrichtigung hinzuzufügen, um den Benutzer bei Bedarf zur Eingabe eines Kennworts aufzufordern, false, um dies dem Anrufer zu überlassen

callback: IAccountManagerCallback

Rückruf, der aufgerufen werden soll, wenn die Anforderung abgeschlossen ist, null für keinen Rückruf

handler: Handler

Handler Identifizieren des Rückrufthreads, NULL für den Hauptthread

Gibt zurück

IAccountManagerFuture

Eine AccountManagerFuture Lösung, die in ein Bundle mit mindestens den folgenden Feldern bei Erfolg aufgelöst wird: <ul<>li>#KEY_ACCOUNT_NAME - der Name des Kontos, das Sie angegeben <haben li>#KEY_ACCOUNT_TYPE - den Typ des Kontos <li>#KEY_AUTHTOKEN - das Authentifizierungstoken, das Sie wollten </ul>

        (Other authenticator-specific values may be returned.)  If the user
        must enter credentials, the returned Bundle contains only
        <code data-dev-comment-type="c">#KEY_INTENT</code> with the <code data-dev-comment-type="c">Intent</code> needed to launch a prompt.

        If an error occurred, <code data-dev-comment-type="c">AccountManagerFuture#getResult()</code> throws:
        &lt;ul&gt;
        &lt;li&gt; <code data-dev-comment-type="c">AuthenticatorException</code> if the authenticator failed to respond
        &lt;li&gt; <code data-dev-comment-type="c">OperationCanceledException</code> if the operation is canceled for
             any reason, incluidng the user canceling a credential request
        &lt;li&gt; <code data-dev-comment-type="c">IOException</code> if the authenticator experienced an I/O problem
             creating a new auth token, usually because of network trouble
        &lt;/ul&gt;
        If the account is no longer present on the device, the return value is
        authenticator-dependent.  The caller should verify the validity of the
        account before requesting an auth token.

Attribute: RegisterAttribute RequiresPermissionAttribute ObsoleteAttribute

Hinweise

Ruft ein Authentifizierungstoken des angegebenen Typs für ein bestimmtes Konto ab, optional wird eine Benachrichtigung ausgelöst, wenn der Benutzer Anmeldeinformationen eingeben muss. Diese Methode ist für Hintergrundaufgaben und Dienste vorgesehen, bei denen der Benutzer nicht sofort mit einer Kennwortaufforderung unterbrochen werden sollte.

Wenn ein zuvor generiertes Authentifizierungstoken für dieses Konto zwischengespeichert und eingegeben wird, wird es zurückgegeben. Andernfalls wird ein gespeichertes Kennwort an den Server gesendet, um ein neues Authentifizierungstoken zu generieren. Andernfalls wird ein Intent Wert zurückgegeben, der den Benutzer beim Starten zur Eingabe eines Kennworts auffordert. Wenn der Parameter notifyAuthFailure festgelegt ist, wird auch eine Statusleistenbenachrichtigung mit demselben Intent erstellt, und der Benutzer wird benachrichtigt, dass er zu einem bestimmten Zeitpunkt ein Kennwort eingeben muss.

In diesem Fall müssen Sie möglicherweise warten, bis der Benutzer antwortet, was Stunden oder Tage oder für immer dauern kann. Wenn der Benutzer antwortet und ein neues Kennwort angibt, sendet der Kontomanager die #LOGIN_ACCOUNTS_CHANGED_ACTION Absicht und benachrichtigt OnAccountsUpdateListener , welche Anwendungen zum Erneuten Versuchen verwendet werden können.

Wenn notifyAuthFailure nicht festgelegt ist, liegt es in der Verantwortung der Anwendung, die zurückgegebene Absicht zu einem bestimmten Zeitpunkt zu starten. Auf beide Weise wartet das Ergebnis dieses Aufrufs nicht auf die Benutzeraktion.

Einige Authentifikatoren weisen Authentifizierungstoken <em-Typen></em> auf, deren Wert Authentifikator-abhängig ist. Einige Dienste verwenden unterschiedliche Tokentypen, um auf unterschiedliche Funktionen zuzugreifen , z. B. verwendet Google unterschiedliche Authentifizierungstoken für den Zugriff auf Gmail und Google Calendar für dasselbe Konto.

Diese Methode kann von einem beliebigen Thread aufgerufen werden, aber der zurückgegebene AccountManagerFuture Darf nicht im Hauptthread verwendet werden.

Dieses Element ist veraltet. verwenden Sie stattdessen #getAuthToken(Account, String, android.os.Bundle, boolean, AccountManagerCallback, android.os.Handler)

Java Dokumentation für android.accounts.AccountManager.getAuthToken(android.accounts.Account, java.lang.String, boolean, android.accounts.AccountManagerCallback<android.os.Bundle>, android.os.Handler).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

GetAuthToken(Account, String, Bundle, Activity, IAccountManagerCallback, Handler)

Ruft ein Authentifizierungstoken des angegebenen Typs für ein bestimmtes Konto ab und fordert den Benutzer bei Bedarf zur Eingabe von Anmeldeinformationen auf.

[Android.Runtime.Register("getAuthToken", "(Landroid/accounts/Account;Ljava/lang/String;Landroid/os/Bundle;Landroid/app/Activity;Landroid/accounts/AccountManagerCallback;Landroid/os/Handler;)Landroid/accounts/AccountManagerFuture;", "GetGetAuthToken_Landroid_accounts_Account_Ljava_lang_String_Landroid_os_Bundle_Landroid_app_Activity_Landroid_accounts_AccountManagerCallback_Landroid_os_Handler_Handler")]
[Android.Runtime.RequiresPermission("android.permission.USE_CREDENTIALS")]
public virtual Android.Accounts.IAccountManagerFuture? GetAuthToken(Android.Accounts.Account? account, string? authTokenType, Android.OS.Bundle? options, Android.App.Activity? activity, Android.Accounts.IAccountManagerCallback? callback, Android.OS.Handler? handler);

[<Android.Runtime.Register("getAuthToken", "(Landroid/accounts/Account;Ljava/lang/String;Landroid/os/Bundle;Landroid/app/Activity;Landroid/accounts/AccountManagerCallback;Landroid/os/Handler;)Landroid/accounts/AccountManagerFuture;", "GetGetAuthToken_Landroid_accounts_Account_Ljava_lang_String_Landroid_os_Bundle_Landroid_app_Activity_Landroid_accounts_AccountManagerCallback_Landroid_os_Handler_Handler")>]
[<Android.Runtime.RequiresPermission("android.permission.USE_CREDENTIALS")>]
abstract member GetAuthToken : Android.Accounts.Account * string * Android.OS.Bundle * Android.App.Activity * Android.Accounts.IAccountManagerCallback * Android.OS.Handler -> Android.Accounts.IAccountManagerFuture
override this.GetAuthToken : Android.Accounts.Account * string * Android.OS.Bundle * Android.App.Activity * Android.Accounts.IAccountManagerCallback * Android.OS.Handler -> Android.Accounts.IAccountManagerFuture

Parameter

account: Account

Das Konto zum Abrufen eines Authentifizierungstokens für

authTokenType: String

Der Authentifizierungstokentyp, ein Authentifikator-abhängiges Zeichenfolgentoken, darf nicht null sein.

options: Bundle

Authentifikatorspezifische Optionen für die Anforderung können null oder leer sein.

activity: Activity

Der Activity Kontext, der zum Starten einer neuen Authentifikator-definierten Unteraktivität verwendet werden soll, um den Benutzer bei Bedarf zur Eingabe eines Kennworts aufzufordern; wird nur verwendet, um startActivity() aufzurufen; darf nicht null sein.

callback: IAccountManagerCallback

Rückruf, der aufgerufen werden soll, wenn die Anforderung abgeschlossen ist, null für keinen Rückruf

handler: Handler

Handler Identifizieren des Rückrufthreads, NULL für den Hauptthread

Gibt zurück

IAccountManagerFuture

Ein AccountManagerFuture Auflöst in ein Bundle mit mindestens den folgenden Feldern: <ul><li#KEY_ACCOUNT_NAME> - der Name des kontos, das Sie angegeben <haben li#KEY_ACCOUNT_TYPE> - den Typ des Kontos <li>#KEY_AUTHTOKEN - das Authentifizierungstoken, das Sie wollten </ul>

        (Other authenticator-specific values may be returned.)  If an auth token
        could not be fetched, <code data-dev-comment-type="c">AccountManagerFuture#getResult()</code> throws:
        &lt;ul&gt;
        &lt;li&gt; <code data-dev-comment-type="c">AuthenticatorException</code> if the authenticator failed to respond
        &lt;li&gt; <code data-dev-comment-type="c">OperationCanceledException</code> if the operation is canceled for
             any reason, incluidng the user canceling a credential request
        &lt;li&gt; <code data-dev-comment-type="c">IOException</code> if the authenticator experienced an I/O problem
             creating a new auth token, usually because of network trouble
        &lt;/ul&gt;
        If the account is no longer present on the device, the return value is
        authenticator-dependent.  The caller should verify the validity of the
        account before requesting an auth token.

Attribute: RegisterAttribute RequiresPermissionAttribute

Hinweise

Ruft ein Authentifizierungstoken des angegebenen Typs für ein bestimmtes Konto ab und fordert den Benutzer bei Bedarf zur Eingabe von Anmeldeinformationen auf. Diese Methode ist für Anwendungen vorgesehen, die im Vordergrund ausgeführt werden, wo es sinnvoll ist, den Benutzer direkt nach einem Kennwort zu fragen.

<b>HINWEIS:</b> Wenn Ihre App für die Arbeit auf API-Ebene 22 und vorher vorgesehen ist, ist USE_CREDENTIALS Berechtigung für diese Plattformen erforderlich. Siehe Dokumente für diese Funktion in API-Ebene 22.

Diese Methode kann von einem beliebigen Thread aufgerufen werden, aber der zurückgegebene AccountManagerFuture Darf nicht im Hauptthread verwendet werden.

Java Dokumentation für android.accounts.AccountManager.getAuthToken(android.accounts.Account, java.lang.String, android.os.Bundle, android.app.Activity, android.accounts.AccountManagerCallback<android.os.Bundle>, android.os.Handler).

Gilt für:

GetAuthToken(Account, String, Bundle, Boolean, IAccountManagerCallback, Handler)

Ruft ein Authentifizierungstoken des angegebenen Typs für ein bestimmtes Konto ab, optional wird eine Benachrichtigung ausgelöst, wenn der Benutzer Anmeldeinformationen eingeben muss.

[Android.Runtime.Register("getAuthToken", "(Landroid/accounts/Account;Ljava/lang/String;Landroid/os/Bundle;ZLandroid/accounts/AccountManagerCallback;Landroid/os/Handler;)Landroid/accounts/AccountManagerFuture;", "GetGetAuthToken_Landroid_accounts_Account_Ljava_lang_String_Landroid_os_Bundle_ZLandroid_accounts_AccountManagerCallback_Landroid_os_Handler_Handler")]
[Android.Runtime.RequiresPermission("android.permission.USE_CREDENTIALS")]
public virtual Android.Accounts.IAccountManagerFuture? GetAuthToken(Android.Accounts.Account? account, string? authTokenType, Android.OS.Bundle? options, bool notifyAuthFailure, Android.Accounts.IAccountManagerCallback? callback, Android.OS.Handler? handler);

[<Android.Runtime.Register("getAuthToken", "(Landroid/accounts/Account;Ljava/lang/String;Landroid/os/Bundle;ZLandroid/accounts/AccountManagerCallback;Landroid/os/Handler;)Landroid/accounts/AccountManagerFuture;", "GetGetAuthToken_Landroid_accounts_Account_Ljava_lang_String_Landroid_os_Bundle_ZLandroid_accounts_AccountManagerCallback_Landroid_os_Handler_Handler")>]
[<Android.Runtime.RequiresPermission("android.permission.USE_CREDENTIALS")>]
abstract member GetAuthToken : Android.Accounts.Account * string * Android.OS.Bundle * bool * Android.Accounts.IAccountManagerCallback * Android.OS.Handler -> Android.Accounts.IAccountManagerFuture
override this.GetAuthToken : Android.Accounts.Account * string * Android.OS.Bundle * bool * Android.Accounts.IAccountManagerCallback * Android.OS.Handler -> Android.Accounts.IAccountManagerFuture

Parameter

account: Account

Das Konto zum Abrufen eines Authentifizierungstokens für

authTokenType: String

Der Authentifizierungstokentyp, ein Authentifikator-abhängiges Zeichenfolgentoken, darf nicht null sein.

options: Bundle

Authentifikatorspezifische Optionen für die Anforderung können null oder leer sein.

notifyAuthFailure: Boolean

True, um eine Benachrichtigung hinzuzufügen, um den Benutzer bei Bedarf zur Eingabe eines Kennworts aufzufordern, false, um dies dem Anrufer zu überlassen

callback: IAccountManagerCallback

Rückruf, der aufgerufen werden soll, wenn die Anforderung abgeschlossen ist, null für keinen Rückruf

handler: Handler

Handler Identifizieren des Rückrufthreads, NULL für den Hauptthread

Gibt zurück

IAccountManagerFuture

        (Other authenticator-specific values may be returned.)  If the user
        must enter credentials, the returned Bundle contains only
        <code data-dev-comment-type="c">#KEY_INTENT</code> with the <code data-dev-comment-type="c">Intent</code> needed to launch a prompt.

        If an error occurred, <code data-dev-comment-type="c">AccountManagerFuture#getResult()</code> throws:
        &lt;ul&gt;
        &lt;li&gt; <code data-dev-comment-type="c">AuthenticatorException</code> if the authenticator failed to respond
        &lt;li&gt; <code data-dev-comment-type="c">OperationCanceledException</code> if the operation is canceled for
             any reason, incluidng the user canceling a credential request
        &lt;li&gt; <code data-dev-comment-type="c">IOException</code> if the authenticator experienced an I/O problem
             creating a new auth token, usually because of network trouble
        &lt;/ul&gt;
        If the account is no longer present on the device, the return value is
        authenticator-dependent.  The caller should verify the validity of the
        account before requesting an auth token.

Attribute: RegisterAttribute RequiresPermissionAttribute

Hinweise

Diese Methode kann von einem beliebigen Thread aufgerufen werden, aber der zurückgegebene AccountManagerFuture Darf nicht im Hauptthread verwendet werden.

Java Dokumentation für android.accounts.AccountManager.getAuthToken(android.accounts.Account, java.lang.String, android.os.Bundle, boolean, android.accounts.AccountManagerCallback<android.os.Bundle>, android.os.Handler).

Gilt für: