Skip to main content

XUserGetLocalId

Récupère un ID de session de jeu unique pour un utilisateur.

Syntaxe

Paramètres

user   _In_
Type : XUserHandle
Handle de l’utilisateur dont l’ID local doit être récupéré. userLocalId   _Out_
Type : XUserLocalId*
Contient un ID de session de jeu unique pour un utilisateur.

Valeur de retour

Type : HRESULT Code de réussite ou d’erreur HRESULT.
Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur.

Remarques

Pour récupérer l’ID d’utilisateur d’un utilisateur spécifique, appelez XUserGetId. Pour récupérer l’état d’un utilisateur spécifique, appelez XUserGetState. Pour récupérer la tranche d’âge d’un utilisateur spécifique, appelez XUserGetAgeGroup. XUserLocalId identifie de manière unique un utilisateur au sein d’une session de jeu. Si vous dupliquez XUserHandle, les deux handles conservent le même XUserLocalId. Une fois la session de jeu terminée, le même utilisateur peut avoir un XUserLocalId différent lors de la session suivante. N’utilisez pas ces ID pour suivre les utilisateurs d’une session de jeu à l’autre. L’exemple suivant montre comment utiliser XUserLocalId pour récupérer le point de terminaison audio par défaut d’un utilisateur.

Configuration requise

En-tête : XUser.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, Steam Deck, consoles de la famille XBOX One et consoles XBOX Series

Voir aussi

XUser XUserGetId XUserGetState XUserGetAgeGroup
Last modified on October 6, 2026