Skip to main content

​
XUserFindUserByLocalId

Récupère un handle vers l’utilisateur correspondant à un ID d’utilisateur local spécifique.

​
Syntaxe

​
Paramètres

userLocalId   _In_
Type : XUserLocalId ID local pour lequel obtenir l’utilisateur. handle   _Out_
Type : XUserHandle* Contient un handle vers l’utilisateur associé à un ID d’utilisateur local spécifique.

​
Valeur de retour

Il n’est pas sûr d’appeler cette fonction sur un thread à durée critique. Pour plus d’informations, consultez Threads à durée critique.
Type : HRESULT Code de réussite ou d’erreur HRESULT.

​
Remarques

Pour chaque handle XUserHandle que vous récupérez à partir d’une API XUser, y compris XUserFindUserByLocalId, vous devez fermer ce handle en appelant XUserCloseHandle. Le nombre de références du handle augmente après l’appel des fonctions Get / Find. Pour récupérer un handle vers un utilisateur correspondant à un ID d’utilisateur local spécifique, appelez XUserFindUserByLocalId. Pour récupérer l’ID utilisateur XBOX (XUID) d’un utilisateur local, appelez XUserFindUserById. Pour récupérer un ID d’utilisateur correspondant à un ID d’appareil spécifique, appelez XUserFindForDevice.

​
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

​
Documentation conceptuelle

​
Voir aussi

XUser XUserFindUserById XUserFindForDevice
Last modified on October 6, 2026