通过

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 帐户管理器。

适用于