XUserGetGamertag

Recupera o gamertag de um usuário específico.

Sintaxe

HRESULT XUserGetGamertag(  
         XUserHandle user,
         XUserGamertagComponent gamertagComponent,
         size_t gamertagSize,  
         char* gamertag,  
         size_t* gamertagUsed  
)  

Parâmetros

user   _In_
Tipo: XUserHandle Um identificador para o usuário cujo gamertag será recuperado. gamertagComponent   _In_
Tipo: XUserGamertagComponent Tipo de gamertag a ser recuperado. gamertagSize   _In_
Tipo: size_t Tamanho em bytes do buffer no parâmetro gamertag. gamertag   _Out_writes_bytes_to_(gamertagSize,gamertagUsed)
Tipo: char Contém o gamertag de um usuário específico. gamertagUsed   _Out_opt_
Tipo: size_t* Contém a quantidade do buffer usada para armazenar o gamertag.

Valor retornado

Tipo: HRESULT Código de sucesso ou erro HRESULT.

Código de retorno	Descrição
S_OK	A operação foi bem-sucedida.
E_GAMEUSER_RESOLVE_USER_ISSUE_REQUIRED	O usuário deve usar uma interface do usuário para resolver o problema. Chame XUserResolveIssueWithUiAsync para exibir a interface do usuário.
E_INSUFFICIENT_BUFFER	O tamanho do buffer indicado por gamertagSize não é grande o suficiente para conter o componente solicitado.
E_INVALIDARG	gamertagComponent inválido fornecido.

Para obter uma lista de códigos de erro, consulte Códigos de erro.

Comentários

Para recuperar a ID de usuário de um usuário específico, chame XUserGetId. Para recuperar o estado de um usuário específico, chame XUserGetState. Para recuperar a faixa etária de um usuário específico, chame XUserGetAgeGroup.

Requisitos

Cabeçalho: XUser.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, Steam Deck, consoles da família XBOX One e consoles XBOX Series

Confira também

XUser XUserGetId XUserGetState XUserGetAgeGroup

Porting

Build Paths

XUserGetGamertag

XUserGetGamertag

Sintaxe

Parâmetros

Valor retornado

Comentários

Requisitos

Confira também

​XUserGetGamertag

​Sintaxe

​Parâmetros

​Valor retornado

​Comentários

​Requisitos

​Confira também

XUserGetGamertag

Sintaxe

Parâmetros

Valor retornado

Comentários

Requisitos

Confira também