Skip to main content

XUserGetLocalId

擷取使用者的唯一遊戲工作階段識別碼。

語法

參數

user   _In_
類型:XUserHandle
要擷取其本機識別碼之使用者的控制代碼。 userLocalId   _Out_
類型:XUserLocalId*
包含使用者的唯一遊戲工作階段識別碼。

傳回值

類型:HRESULT HRESULT 成功或錯誤碼。
如需錯誤碼清單,請參閱錯誤碼。

備註

若要擷取特定使用者的使用者識別碼,請呼叫 XUserGetId。 若要擷取特定使用者的狀態,請呼叫 XUserGetState。 若要擷取特定使用者的年齡層,請呼叫 XUserGetAgeGroup。 XUserLocalId 可在遊戲工作階段內唯一識別使用者。如果您複製 XUserHandle,兩個控制代碼都會保有相同的 XUserLocalId。遊戲工作階段結束後,同一個使用者在下一個工作階段中可能會有不同的 XUserLocalId。請勿使用這些識別碼跨遊戲工作階段追蹤使用者。 下列範例示範如何使用 XUserLocalId 擷取使用者的預設音訊端點。

需求

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

另請參閱

XUser XUserGetId XUserGetState XUserGetAgeGroup
Last modified on October 6, 2026