UserIdentity 類別

定義

命名空間:

Windows.Security.Authentication.OnlineId

包含與使用者相關聯的識別碼、票證和其他資訊。

注意

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

public ref class UserIdentity sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class UserIdentity final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class UserIdentity

Public NotInheritable Class UserIdentity

繼承

Object Platform::Object IInspectable UserIdentity

屬性

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

範例

List<OnlineIdServiceTicketRequest> targetArray = new List<OnlineIdServiceTicketRequest>();
targetArray.Add(new OnlineIdServiceTicketRequest("wl.basic wl.contacts_photos wl.calendars",
        "DELEGATION"));

DebugPrint("Signing in ...");

Windows.Security.Authentication.OnlineId.UserIdentity result = 
        await _authenticator.AuthenticateUserAsync(targetArray, CredentialPromptType.PromptIfNeeded);

if (result.Tickets[0].Value != string.Empty)
{
    DebugPrint("Signed in.");
    IsNotSignedIn = false;
}
else
{
    // Handle errors like bad parameter, misconfigured target, and so on.
    DebugPrint("Unable to get the ticket. Error: " + result.Tickets[0].ErrorCode.ToString());
    IsNotSignedIn = true;
}

屬性

FirstName	包含使用者的名字。 此值僅適用于 Microsoft 應用程式合作夥伴。 注意 如果您要針對Windows 10或更新版本進行開發，請改用Windows.Security.Authentication.Web.Core API。 如需詳細資訊，請參閱 Web 帳戶管理員。
Id	取得使用者的唯一 Microsoft 帳戶識別碼。 此值僅適用于 Microsoft 應用程式合作夥伴。 注意 如果您要針對Windows 10或更新版本進行開發，請改用Windows.Security.Authentication.Web.Core API。 如需詳細資訊，請參閱 Web 帳戶管理員。
IsBetaAccount	指出使用者是否為 Beta 程式的一部分。 此值僅適用于 Microsoft 應用程式合作夥伴。 注意 如果您要針對Windows 10或更新版本進行開發，請改用Windows.Security.Authentication.Web.Core API。 如需詳細資訊，請參閱 Web 帳戶管理員。
IsConfirmedPC	指出使用者是否在已確認為其電腦的電腦上。 此值僅適用于 Microsoft 應用程式合作夥伴。 注意 如果您要針對Windows 10或更新版本進行開發，請改用Windows.Security.Authentication.Web.Core API。 如需詳細資訊，請參閱 Web 帳戶管理員。
LastName	包含使用者的姓氏。 此值僅適用于 Microsoft 應用程式合作夥伴。 注意 如果您要針對Windows 10或更新版本進行開發，請改用Windows.Security.Authentication.Web.Core API。 如需詳細資訊，請參閱 Web 帳戶管理員。
SafeCustomerId	取得呼叫端應用程式特定的模糊化客戶識別碼。 此識別碼可讓您的應用程式跨會話識別使用者，但無法用來在個別的應用程式之間共用資料，因為每個應用程式都會收到相同 Microsoft 帳戶的相異 SafeCustomerId 值。 注意 如果您要針對Windows 10或更新版本進行開發，請改用Windows.Security.Authentication.Web.Core API。 如需詳細資訊，請參閱 Web 帳戶管理員。
SignInName	使用者的登入名稱。 此值僅適用于 Microsoft 應用程式合作夥伴。 注意 如果您要針對Windows 10或更新版本進行開發，請改用Windows.Security.Authentication.Web.Core API。 如需詳細資訊，請參閱 Web 帳戶管理員。
Tickets	包含可識別使用者的票證陣列。 如果您的應用程式使用 JWT 原則，則只會傳回一個票證。 此值僅適用于 Microsoft 應用程式合作夥伴。 注意 如果您要針對Windows 10或更新版本進行開發，請改用Windows.Security.Authentication.Web.Core API。 如需詳細資訊，請參閱 Web 帳戶管理員。