SystemIdentification.GetSystemIdForUser(User) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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).