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 成功或錯誤碼。 如需錯誤碼清單,請參閱錯誤碼。

備註

若要擷取特定使用者的使用者識別碼,請呼叫 XUserGetId。 若要擷取特定使用者的狀態,請呼叫 XUserGetState。 若要擷取特定使用者的年齡層,請呼叫 XUserGetAgeGroup。

需求

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

另請參閱

XUser XUserGetId XUserGetState XUserGetAgeGroup
Last modified on October 6, 2026