跳轉到主要內容

​
XUserFindUserByLocalId

擷取特定本機使用者識別碼的使用者控制代碼。

​
語法

​
參數

userLocalId   _In_
類型：XUserLocalId 要取得其使用者的本機識別碼。 handle   _Out_
類型：XUserHandle* 包含與特定本機使用者識別碼相關聯之使用者的控制代碼。

​
傳回值

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊，請參閱時間敏感執行緒。
類型：HRESULT HRESULT 成功或錯誤碼。

​
備註

對於從 XUser API (包括 XUserFindUserByLocalId) 擷取的每個 XUserHandle 控制代碼，您都必須 呼叫 XUserCloseHandle 來關閉該控制代碼。呼叫 Get / Find 函式之後，控制代碼的參考計數會增加。 若要擷取特定本機使用者識別碼的使用者控制代碼，請呼叫 XUserFindUserByLocalId。 若要擷取本機使用者的 XBOX 使用者識別碼 (XUID)，請呼叫 XUserFindUserById。 若要擷取特定裝置識別碼的使用者識別碼，請呼叫 XUserFindForDevice。

​
需求

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

​
概念文件

​
另請參閱

XUser XUserFindUserById XUserFindForDevice
最後修改於 2026年10月19日