Skip to main content

​
XUserFindUserByLocalId

Récupère un handle d’utilisateur pour un ID d’utilisateur local donné.

​
Syntaxe

​
Paramètres

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

​
Valeur de retour

Il n’est pas sécuritaire d’appeler cette fonction sur un thread sensible au temps. Pour plus d’informations, consultez Threads sensibles au temps.
Type : HRESULT Code de réussite ou d’erreur HRESULT.

​
Remarques

Pour chaque handle XUserHandle que vous récupérez 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 d’utilisateur pour un ID d’utilisateur local donné, appelez XUserFindUserByLocalId. Pour récupérer l’ID d’utilisateur XBOX (XUID) d’un utilisateur local, appelez XUserFindUserById. Pour récupérer un ID d’utilisateur pour un ID d’appareil donné, 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