OnlineIdAuthenticator.AuthenticateUserAsync Methode
Definition
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
| 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 UserAuthenticationOperationParameter
- 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
Ein Objekt, das den Authentifizierungsvorgang darstellt.
- Attribute
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
Gilt für:
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 UserAuthenticationOperationParameter
Eine Auflistung von Anforderungen.
- credentialPromptType
- CredentialPromptType
Der Typ der Anmeldeinformationen.
Gibt zurück
Ein Objekt, das den Authentifizierungsvorgang darstellt.
- Attribute