SystemIdentification.GetSystemIdForUser(User) Método

Definição

Namespace:

Windows.System.Profile

Obtém um valor de identificador para o sistema com base na ID do usuário.

public:
 static SystemIdentificationInfo ^ GetSystemIdForUser(User ^ user);

 static SystemIdentificationInfo GetSystemIdForUser(User const& user);

public static SystemIdentificationInfo GetSystemIdForUser(User user);

function getSystemIdForUser(user)

Public Shared Function GetSystemIdForUser (user As User) As SystemIdentificationInfo

Parâmetros

user

User

Os dados do usuário a serem usados para criar a ID do sistema. Se o valor for null, esse método obterá a ID do usuário atual.

Retornos

SystemIdentificationInfo

Um objeto SystemIdentificationInfo para esse sistema, com base na ID do usuário.

Requisitos do Windows

Requisitos	Description
Funcionalidades do aplicativo	userSystemId

Comentários

O identificador retornado por esse método é específico para um usuário no dispositivo atual e permite a correlação de uso entre diferentes aplicativos em execução no mesmo dispositivo para um usuário específico. Os aplicativos que não têm reconhecimento de vários usuários só devem passar null para esse método, que obtém a ID do usuário atual.

O uso desse método é restrito pela funcionalidade userSystemId, que é uma funcionalidade restrita que exige aprovação Microsoft. Observe que a maioria dos chamadores deve usar o Windows. Em vez disso, o método System.Profile.SystemIdentification.GetSystemIdForPublisher é mais apropriado para a grande maioria dos casos de uso e não requer uma funcionalidade restrita. Se você não precisar obter uma ID compartilhada entre aplicativos criados por diferentes editores, não deverá usar esse método.

Observação

Esse método retorna um identificador destinado à correlação e não fornece um User objeto. Para acessar as propriedades do usuário atual (como nome de exibição ou nome de conta), use Windows. System.User.GetDefault (Windows 10, versão 2104+) e, em seguida, consultar propriedades por meio de User.GetPropertyAsync com KnownUserProperties (requer a funcionalidade userAccountInformation).