OnlineIdAuthenticator.AuthenticateUserAsync 方法

定義

命名空間:

Windows.Security.Authentication.OnlineId

多載

AuthenticateUserAsync(OnlineIdServiceTicketRequest)	視需要收集認證或同意並取得票證，使用 one OnlineIdServiceTicketRequest 啟動非同步驗證要求。 如果使用者使用 Microsoft 帳戶登入 Windows 8 系統，此使用者將用於驗證要求。 注意 如果您要針對Windows 10或更新版本進行開發，請改用Windows.Security.Authentication.Web.Core API。 如需詳細資訊，請參閱 Web 帳戶管理員。
AuthenticateUserAsync(IIterable<OnlineIdServiceTicketRequest>, CredentialPromptType)	使用多個 OnlineIdServiceTicketRequests 啟動非同步驗證要求，並提供設定 CredentialPromptType 以取得票證來控制使用者體驗的能力。 如果使用者使用 Microsoft 帳戶登入 Windows 8 系統，此使用者將用於驗證要求。 注意 如果您要針對Windows 10或更新版本進行開發，請改用Windows.Security.Authentication.Web.Core API。 如需詳細資訊，請參閱 Web 帳戶管理員。

AuthenticateUserAsync(OnlineIdServiceTicketRequest)

視需要收集認證或同意並取得票證，使用 one OnlineIdServiceTicketRequest 啟動非同步驗證要求。 如果使用者使用 Microsoft 帳戶登入 Windows 8 系統，此使用者將用於驗證要求。

注意

如果您要針對Windows 10或更新版本進行開發，請改用Windows.Security.Authentication.Web.Core API。 如需詳細資訊，請參閱 Web 帳戶管理員。

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 使用者以取得身分識別屬性和票證的服務與原則。

傳回

UserAuthenticationOperation

表示驗證作業的物件。

屬性

OverloadAttribute

備註

使用這些方法時，請考慮下列錯誤處理指導方針：

• 如果非同步驗證要求失敗，則會在 IAsyncInfo 物件的 errorcode 中擷取錯誤。
• 如果非同步驗證要求啟動，但已取得某些票證，但其中某些票證失敗，回應會S_OK。
• 如果驗證要求本身成功，但無法要求個別票證， IAsyncInfo 會傳回S_OK但 OnlineIdServiceTicket.ErrorCode 會擷取個別票證錯誤碼。
• 如果所有票證要求失敗， IAsyncInfo 將會包含實際的錯誤碼。
• 如果所有呼叫都成功且成功取得所有票證，錯誤碼將會S_OK指出未發生任何錯誤。

另請參閱

• AuthenticateUserAsync(IIterable<OnlineIdServiceTicketRequest>, CredentialPromptType)

AuthenticateUserAsync(IIterable<OnlineIdServiceTicketRequest>, CredentialPromptType)

使用多個 OnlineIdServiceTicketRequests 啟動非同步驗證要求，並提供設定 CredentialPromptType 以取得票證來控制使用者體驗的能力。 如果使用者使用 Microsoft 帳戶登入 Windows 8 系統，此使用者將用於驗證要求。

注意

如果您要針對Windows 10或更新版本進行開發，請改用Windows.Security.Authentication.Web.Core API。 如需詳細資訊，請參閱 Web 帳戶管理員。

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

參數

requests

IIterable<OnlineIdServiceTicketRequest>

IEnumerable<OnlineIdServiceTicketRequest>

要求的集合。

credentialPromptType

CredentialPromptType

認證的類型。

傳回

UserAuthenticationOperation

表示驗證作業的物件。

屬性

OverloadAttribute

另請參閱

• AuthenticateUserAsync(OnlineIdServiceTicketRequest)