Skip to main content

XUserGetLocalId

Recupera uma ID de sessão de jogo exclusiva para um usuário.

Sintaxe

Parâmetros

user   _In_
Tipo: XUserHandle
Um identificador para o usuário cuja ID local será recuperada. userLocalId   _Out_
Tipo: XUserLocalId*
Contém uma ID de sessão de jogo exclusiva para um usuário.

Valor retornado

Tipo: HRESULT Código de sucesso ou erro HRESULT.
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. O XUserLocalId identifica exclusivamente um usuário em uma sessão de jogo. Se você duplicar o XUserHandle, ambos os identificadores manterão o mesmo XUserLocalId. Quando a sessão de jogo terminar, o mesmo usuário poderá ter um XUserLocalId diferente durante a próxima sessão. Não use essas IDs para rastrear usuários entre sessões de jogo. O exemplo a seguir demonstra como usar o XUserLocalId para recuperar o ponto de extremidade de áudio padrão de um usuário.

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
Last modified on October 6, 2026