UserIdentity 类

定义

命名空间:

Windows.Security.Authentication.OnlineId

包含 ID、票证以及与用户关联的其他信息。

注意

如果要针对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	获取特定于调用应用程序的模糊客户 ID。 此 ID 允许应用程序跨会话标识用户，但不能用于在单独的应用程序之间共享数据，因为每个应用程序将接收同一 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 帐户管理器。