Skip to main content

​
XUserFindForDevice

擷取特定裝置識別碼的使用者識別碼。

​
語法

​
參數

deviceId   _In_
類型：APP_LOCAL_DEVICE_ID* 裝置的識別碼。
handle   _Out_
類型：XUserHandle* 包含本機使用者的 XUID。

​
傳回值

類型：HRESULT 如果成功，則傳回 S_OK；否則傳回錯誤碼。 如需錯誤碼清單，請參閱錯誤碼。

​
備註

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊，請參閱時間敏感執行緒。
使用者與裝置之間的關聯可能因許多原因而變更：
  • 使用者從主機登出。
  • 有人使用輸入裝置在帳戶選擇器中選取其他使用者。
若要在使用者與裝置的關聯變更時收到通知，請呼叫 XUserRegisterForDeviceAssociationChanged 以取得 XUserDeviceAssociationChangedCallback。
XUserFindForDevice 無法傳回尚未透過呼叫 XUserAddAsync 登入之使用者的使用者控制代碼。如需詳細資訊，請參閱使用者與輸入裝置。

​
需求

標頭： XUser.h 程式庫： xgameruntime.lib 支援的平台： Windows、XBOX One 系列主機和 XBOX Series 主機

​
概念文件

​
另請參閱

XUser XUserRegisterForDeviceAssociationChanged XUserDeviceAssociationChangedCallback
Last modified on October 6, 2026