OnlineIdAuthenticator.AuthenticateUserAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| AuthenticateUserAsync(OnlineIdServiceTicketRequest) |
Запускает асинхронный запрос проверки подлинности с помощью одного onlineIdServiceTicketRequest , отображая запрос учетных данных, если это необходимо для сбора учетных данных или согласия и получения билета. Если пользователь вошел в систему Windows 8 с помощью учетной записи Майкрософт, этот пользователь будет использоваться для запроса проверки подлинности. Примечание Если вы разрабатываете для Windows 10 или более поздней версии, используйте ВМЕСТО них API Windows.Security.Authentication.Web.Core . Дополнительные сведения см. в разделе Диспетчер веб-учетных записей. |
| AuthenticateUserAsync(IIterable<OnlineIdServiceTicketRequest>, CredentialPromptType) |
Запускает запрос асинхронной проверки подлинности с несколькими запросами OnlineIdServiceTicketRequest и предоставляет возможность управлять взаимодействием с пользователем, задавая CredentialPromptType для получения билетов. Если пользователь вошел в систему Windows 8 с помощью учетной записи Майкрософт, этот пользователь будет использоваться для запроса проверки подлинности. Примечание Если вы разрабатываете для Windows 10 или более поздней версии, используйте ВМЕСТО них API Windows.Security.Authentication.Web.Core . Дополнительные сведения см. в разделе Диспетчер веб-учетных записей. |
AuthenticateUserAsync(OnlineIdServiceTicketRequest)
Запускает асинхронный запрос проверки подлинности с помощью одного onlineIdServiceTicketRequest , отображая запрос учетных данных, если это необходимо для сбора учетных данных или согласия и получения билета. Если пользователь вошел в систему Windows 8 с помощью учетной записи Майкрософт, этот пользователь будет использоваться для запроса проверки подлинности.
Примечание
Если вы разрабатываете для Windows 10 или более поздней версии, используйте ВМЕСТО них API Windows.Security.Authentication.Web.Core . Дополнительные сведения см. в разделе Диспетчер веб-учетных записей.
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Параметры
- request
- OnlineIdServiceTicketRequest
Объект запроса, предоставляющий приложению возможность указать службу и политику, используемые для проверки подлинности пользователя Live, чтобы получить свойства удостоверения и билеты.
Возвращаемое значение
Объект , представляющий операцию проверки подлинности.
- Атрибуты
Комментарии
При использовании этих методов учитывайте следующие рекомендации по обработке ошибок.
- Если асинхронный запрос проверки подлинности завершается сбоем, ошибка фиксируется в коде ошибки объекта IAsyncInfo .
- Если асинхронные запросы проверки подлинности запускаются и некоторые из них были получены, но некоторые из них завершились ошибкой, ответ будет S_OK.
- Если сам запрос проверки подлинности выполнен успешно, но не удалось запросить отдельные билеты, IAsyncInfo возвращает S_OK но OnlineIdServiceTicket.ErrorCode фиксирует отдельные коды ошибок билета.
- Если все запросы на запросы завершилися ошибкой, IAsyncInfo будет содержать фактический код ошибки.
- Если все вызовы выполнены успешно и все билеты успешно получены, код ошибки будет S_OK, указывающий на отсутствие ошибок.
См. также раздел
Применяется к
AuthenticateUserAsync(IIterable<OnlineIdServiceTicketRequest>, CredentialPromptType)
Запускает запрос асинхронной проверки подлинности с несколькими запросами OnlineIdServiceTicketRequest и предоставляет возможность управлять взаимодействием с пользователем, задавая CredentialPromptType для получения билетов. Если пользователь вошел в систему Windows 8 с помощью учетной записи Майкрософт, этот пользователь будет использоваться для запроса проверки подлинности.
Примечание
Если вы разрабатываете для Windows 10 или более поздней версии, используйте ВМЕСТО них API Windows.Security.Authentication.Web.Core . Дополнительные сведения см. в разделе Диспетчер веб-учетных записей.
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Параметры
Коллекция запросов.
- credentialPromptType
- CredentialPromptType
Тип учетных данных.
Возвращаемое значение
Объект , представляющий операцию проверки подлинности.
- Атрибуты