Skip to main content

​
XUserFindUserById

Recupera o XUserHandle com base na ID de usuário do XBOX (XUID) de um usuário local.

​
Sintaxe

​
Parâmetros

userId   _In_
Tipo: uint64_t O usuário local para o qual recuperar o XUID. handle   _Out_
Tipo: XUserHandle* Contém o XUID do usuário local.

​
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

Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, consulte Threads sensíveis ao tempo.
Para cada identificador XUserHandle que você recuperar de uma API XUser, incluindo XUserFindUserById, você deve fechar esse identificador chamando XUserCloseHandle. Para recuperar a ID de usuário do XBox (XUID) de um usuário local, chame XUserFindUserById. Para recuperar um identificador para um usuário de uma ID de usuário local específica, chame XUserFindUserByLocalId. Para recuperar uma ID de usuário de uma ID de dispositivo específica, chame XUserFindForDevice.

​
Requisitos

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

​
Documentação conceitual

​
Confira também

XUser XUserFindUserByLocalId XUserFindForDevice
Last modified on October 6, 2026