Skip to main content

​
XUserFindUserByLocalId

Recupera um identificador para o usuário de uma ID de usuário local específica.

​
Sintaxe

​
Parâmetros

userLocalId   _In_
Tipo: XUserLocalId A ID local para a qual obter o usuário. handle   _Out_
Tipo: XUserHandle* Contém um identificador para o usuário associado a uma ID de usuário local específica.

​
Valor retornado

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.
Tipo: HRESULT Código de sucesso ou erro HRESULT.

​
Comentários

Para cada identificador XUserHandle que você recuperar de uma API XUser, incluindo XUserFindUserByLocalId, você deve fechar esse identificador chamando XUserCloseHandle. A contagem de referências do identificador aumenta após a chamada de funções Get / Find. Para recuperar um identificador para um usuário de uma ID de usuário local específica, chame XUserFindUserByLocalId. Para recuperar a ID de usuário do XBOX (XUID) de um usuário local, chame XUserFindUserById. 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 XUserFindUserById XUserFindForDevice
Last modified on October 6, 2026