OnlineIdAuthenticator.AuthenticateUserAsync Methode

Definition

Namespace:

Windows.Security.Authentication.OnlineId

Überlädt

AuthenticateUserAsync(OnlineIdServiceTicketRequest)

Startet die asynchrone Authentifizierungsanforderung mit einer OnlineIdServiceTicketRequest , indem die Anmeldeinformationsaufforderung angezeigt wird, falls erforderlich, um Anmeldeinformationen oder Zustimmung zu sammeln und das Ticket zu erhalten. Wenn ein Benutzer mit einem Microsoft-Konto bei einem Windows 8-System angemeldet ist, wird dieser Benutzer für die Authentifizierungsanforderung verwendet. Hinweis Wenn Sie für Windows 10 oder höher entwickeln, verwenden Sie stattdessen die Windows.Security.Authentication.Web.Core-APIs. Weitere Informationen finden Sie unter Web Account Manager.

AuthenticateUserAsync(IIterable<OnlineIdServiceTicketRequest>, CredentialPromptType)

Startet die asynchrone Authentifizierungsanforderung mit mehreren OnlineIdServiceTicketRequests und bietet die Möglichkeit, die Benutzererfahrung zu steuern, indem CredentialPromptType festgelegt wird, um die Tickets zu erhalten. Wenn ein Benutzer mit einem Microsoft-Konto bei einem Windows 8-System angemeldet ist, wird dieser Benutzer für die Authentifizierungsanforderung verwendet. Hinweis Wenn Sie für Windows 10 oder höher entwickeln, verwenden Sie stattdessen die Windows.Security.Authentication.Web.Core-APIs. Weitere Informationen finden Sie unter Web Account Manager.

AuthenticateUserAsync(OnlineIdServiceTicketRequest)

Startet die asynchrone Authentifizierungsanforderung mit einer OnlineIdServiceTicketRequest , indem die Anmeldeinformationsaufforderung angezeigt wird, falls erforderlich, um Anmeldeinformationen oder Zustimmung zu sammeln und das Ticket zu erhalten. Wenn ein Benutzer mit einem Microsoft-Konto bei einem Windows 8-System angemeldet ist, wird dieser Benutzer für die Authentifizierungsanforderung verwendet.

Hinweis

Wenn Sie für Windows 10 oder höher entwickeln, verwenden Sie stattdessen die Windows.Security.Authentication.Web.Core-APIs. Weitere Informationen finden Sie unter Web Account Manager.

public:
 virtual UserAuthenticationOperation ^ AuthenticateUserAsync(OnlineIdServiceTicketRequest ^ request) = AuthenticateUserAsync;

/// [Windows.Foundation.Metadata.Overload("AuthenticateUserAsync")]
UserAuthenticationOperation AuthenticateUserAsync(OnlineIdServiceTicketRequest const& request);

[Windows.Foundation.Metadata.Overload("AuthenticateUserAsync")]
public UserAuthenticationOperation AuthenticateUserAsync(OnlineIdServiceTicketRequest request);

function authenticateUserAsync(request)

Public Function AuthenticateUserAsync (request As OnlineIdServiceTicketRequest) As UserAuthenticationOperation

Parameter

request

OnlineIdServiceTicketRequest

Ein Anforderungsobjekt, das einer App die Möglichkeit bietet, den Dienst und die Richtlinie anzugeben, die zum Authentifizieren eines Live-Benutzers zum Abrufen von Identitätseigenschaften und Tickets verwendet werden.

Gibt zurück

UserAuthenticationOperation

Ein Objekt, das den Authentifizierungsvorgang darstellt.

Attribute

OverloadAttribute

Hinweise

Beachten Sie bei Der Verwendung dieser Methoden die folgenden Richtlinien zur Fehlerbehandlung:

• Wenn die asynchrone Authentifizierungsanforderung fehlschlägt, wird der Fehler im Fehlercode des IAsyncInfo-Objekts erfasst.
• Wenn die asynchronen Authentifizierungsanforderungen gestartet werden und einige der Tickets abgerufen wurden, aber einige davon fehlgeschlagen sind, wird die Antwort S_OK.
• Wenn die Authentifizierungsanforderung selbst erfolgreich war, aber keine einzelnen Tickets angefordert werden konnten, gibt IAsyncInfo S_OK zurück, aber OnlineIdServiceTicket.ErrorCode erfasst einzelne Ticketfehlercodes.
• Wenn alle Ticketanforderungen fehlgeschlagen sind, enthält IAsyncInfo den tatsächlichen Fehlercode.
• Wenn alle Aufrufe erfolgreich waren und alle Tickets erfolgreich abgerufen wurden, wird der Fehlercode S_OK angegeben, dass kein Fehler aufgetreten ist.

Weitere Informationen

• AuthenticateUserAsync(IIterable<OnlineIdServiceTicketRequest>, CredentialPromptType)

AuthenticateUserAsync(IIterable<OnlineIdServiceTicketRequest>, CredentialPromptType)

Startet die asynchrone Authentifizierungsanforderung mit mehreren OnlineIdServiceTicketRequests und bietet die Möglichkeit, die Benutzererfahrung zu steuern, indem CredentialPromptType festgelegt wird, um die Tickets zu erhalten. Wenn ein Benutzer mit einem Microsoft-Konto bei einem Windows 8-System angemeldet ist, wird dieser Benutzer für die Authentifizierungsanforderung verwendet.

Hinweis

Wenn Sie für Windows 10 oder höher entwickeln, verwenden Sie stattdessen die Windows.Security.Authentication.Web.Core-APIs. Weitere Informationen finden Sie unter Web Account Manager.

public:
 virtual UserAuthenticationOperation ^ AuthenticateUserAsync(IIterable<OnlineIdServiceTicketRequest ^> ^ requests, CredentialPromptType credentialPromptType) = AuthenticateUserAsync;

/// [Windows.Foundation.Metadata.Overload("AuthenticateUserAsyncAdvanced")]
UserAuthenticationOperation AuthenticateUserAsync(IIterable<OnlineIdServiceTicketRequest> const& requests, CredentialPromptType const& credentialPromptType);

[Windows.Foundation.Metadata.Overload("AuthenticateUserAsyncAdvanced")]
public UserAuthenticationOperation AuthenticateUserAsync(IEnumerable<OnlineIdServiceTicketRequest> requests, CredentialPromptType credentialPromptType);

function authenticateUserAsync(requests, credentialPromptType)

Public Function AuthenticateUserAsync (requests As IEnumerable(Of OnlineIdServiceTicketRequest), credentialPromptType As CredentialPromptType) As UserAuthenticationOperation

Parameter

requests

IIterable<OnlineIdServiceTicketRequest>

IEnumerable<OnlineIdServiceTicketRequest>

Eine Auflistung von Anforderungen.

credentialPromptType

CredentialPromptType

Der Typ der Anmeldeinformationen.

Gibt zurück

UserAuthenticationOperation

Ein Objekt, das den Authentifizierungsvorgang darstellt.

Attribute

OverloadAttribute

Weitere Informationen

• AuthenticateUserAsync(OnlineIdServiceTicketRequest)