Skip to main content

​
XUserFindForDevice

Récupère l’ID d’utilisateur pour un ID d’appareil donné.

​
Syntaxe

​
Paramètres

deviceId   _In_
Type : APP_LOCAL_DEVICE_ID* ID de l’appareil.
handle   _Out_
Type : XUserHandle* Contient le XUID de l’utilisateur local.

​
Valeur de retour

Type : HRESULT Retourne S_OK en cas de réussite; sinon, retourne un code d’erreur. 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.
L’association entre l’utilisateur et l’appareil peut changer pour de nombreuses raisons :
  • L’utilisateur se déconnecte de la console.
  • Quelqu’un utilise le périphérique d’entrée pour sélectionner un autre utilisateur dans le sélecteur de compte.
Pour recevoir une notification lorsque l’association entre l’utilisateur et l’appareil change, appelez XUserRegisterForDeviceAssociationChanged afin d’obtenir un XUserDeviceAssociationChangedCallback.
XUserFindForDevice ne peut pas retourner de handle d’utilisateur pour un utilisateur qui n’a pas été connecté au moyen d’un appel à XUserAddAsync. Pour plus d’informations, consultez Utilisateurs et périphériques d’entrée.

​
Configuration requise

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

​
Documentation conceptuelle

​
Voir aussi

XUser XUserRegisterForDeviceAssociationChanged XUserDeviceAssociationChangedCallback
Last modified on October 6, 2026