Langue

SystemIdentification.GetSystemIdForUser(User) Méthode

Définition

Obtient une valeur d’identificateur pour le système en fonction de l’ID utilisateur.

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

Paramètres

user
User

Données utilisateur à utiliser pour créer l’ID système. Si la valeur est null, cette méthode obtient l’ID de l’utilisateur actuel.

Retours

Objet SystemIdentificationInfo pour ce système, basé sur l’ID utilisateur.

Configuration requise pour Windows

Configuration requise Description
Fonctionnalités de l’application
userSystemId

Remarques

L’identificateur retourné par cette méthode est spécifique à un utilisateur sur l’appareil actuel et permet la corrélation de l’utilisation entre différentes applications s’exécutant sur le même appareil pour un utilisateur particulier. Les applications qui ne prennent pas en charge plusieurs utilisateurs doivent uniquement passer null à cette méthode, ce qui obtient l’ID de l’utilisateur actuel.

L’utilisation de cette méthode est limitée par la fonctionnalité userSystemId, qui est une fonctionnalité restreinte nécessitant Microsoft approbation. Notez que la plupart des appelants doivent utiliser plutôt le Windows. Méthode System.Profile.SystemIdentification.GetSystemIdForPublisher à la place, car elle est plus appropriée pour la grande majorité des cas d’usage et ne nécessite pas de fonctionnalité restreinte. Si vous n’avez pas besoin d’obtenir un ID partagé entre les applications créées par différents éditeurs, vous ne devez pas utiliser cette méthode.

Remarque

Cette méthode retourne un identificateur destiné à la corrélation et ne fournit pas d’objet User . Pour accéder aux propriétés de l’utilisateur actuel (par exemple, le nom d’affichage ou le nom du compte), utilisez Windows. System.User.GetDefault (Windows 10, version 2104+), puis interrogez les propriétés via User.GetPropertyAsync avec KnownUserProperties (nécessite la fonctionnalité userAccountInformation).

S’applique à