Skip to main content

​
XUserFindUserById

Récupère le XUserHandle en fonction de l’ID d’utilisateur XBOX (XUID) d’un utilisateur local.

​
Syntaxe

​
Paramètres

userId   _In_
Type : uint64_t Utilisateur local dont il faut récupérer le XUID. handle   _Out_
Type : XUserHandle* Contient le XUID de l’utilisateur local.

​
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

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.
Pour chaque handle XUserHandle que vous récupérez d’une API XUser, y compris XUserFindUserById, vous devez fermer ce handle en appelant XUserCloseHandle. Pour récupérer l’ID d’utilisateur XBox (XUID) d’un utilisateur local, appelez XUserFindUserById. Pour récupérer un handle d’utilisateur pour un ID d’utilisateur local donné, appelez XUserFindUserByLocalId. 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 XUserFindUserByLocalId XUserFindForDevice
Last modified on October 6, 2026