Passer au contenu principal

​
XUserFindForDevice

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

​
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ûr d’appeler cette fonction sur un thread à durée critique. Pour plus d’informations, consultez Threads à durée critique.
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 ne s’est pas connecté via 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
Dernière modification le 19 octobre 2026