Skip to main content

XUserGetGamertag

检索特定用户的玩家代号。

语法

参数

user   _In_
类型:XUserHandle
要检索玩家代号的用户的句柄。 gamertagComponent   _In_
类型:XUserGamertagComponent
要检索的玩家代号类型。 gamertagSize   _In_
类型:size_t
gamertag 参数中缓冲区的大小(以字节为单位)。 gamertag   _Out_writes_bytes_to_(gamertagSize,gamertagUsed)
类型:char
包含特定用户的玩家代号。 gamertagUsed   _Out_opt_
类型:size_t*
包含用于存放玩家代号的缓冲区数量。

返回值

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

注解

若要检索特定用户的用户 ID,请调用 XUserGetId 若要检索特定用户的状态,请调用 XUserGetState 若要检索特定用户的年龄组,请调用 XUserGetAgeGroup

要求

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

另请参阅

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