Skip to main content

XUserGetLocalId

检索用户的唯一游戏会话 ID。

语法

参数

user   _In_
类型:XUserHandle
要检索本地 ID 的用户的句柄。 userLocalId   _Out_
类型:XUserLocalId*
包含用户的唯一游戏会话 ID。

返回值

类型:HRESULT HRESULT 成功或错误代码。
有关错误代码列表,请参阅错误代码

注解

若要检索特定用户的用户 ID,请调用 XUserGetId 若要检索特定用户的状态,请调用 XUserGetState 若要检索特定用户的年龄组,请调用 XUserGetAgeGroup XUserLocalId 在游戏会话中唯一标识一个用户。如果复制 XUserHandle,则两个句柄将维护相同的 XUserLocalId。一旦游戏会话结束,同一用户在下一次会话期间可能具有不同的 XUserLocalId。请勿使用这些 ID 跨游戏会话跟踪用户。 以下示例演示如何使用 XUserLocalId 检索用户的默认音频终结点。

要求

头文件: XUser.h 库: xgameruntime.lib 支持的平台: Windows、Steam Deck、XBOX One 系列主机和 XBOX Series 主机

另请参阅

XUser XUserGetId XUserGetState XUserGetAgeGroup
最后修改于 2026年8月24日