> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XUserGetState

> XUserGetState

# XUserGetState

Recupera o estado de um usuário.

## Sintaxe

```cpp theme={null}
HRESULT XUserGetState(  
         XUserHandle user,  
         XUserState* state  
)  
```

### Parâmetros

*user*   \_In\_\
Tipo: XUserHandle

Um identificador para o usuário cujo estado será recuperado.

*state*   \_Out\_\
Tipo: [XUserState\*](https://docs.xbox.com/pt-BR/reference/system/xuser/enums/xuserstate.md)

Contém o estado de um usuário específico.

### Valor retornado

Tipo: HRESULT

Código de êxito ou erro HRESULT.\
Para obter uma lista de códigos de erro, confira [Códigos de erro](https://docs.xbox.com/pt-BR/reference/errorcodes.md).

## Comentários

Um usuário pode existir em três estados dentro de um título de jogo. Para obter detalhes, acesse [XUserState](https://docs.xbox.com/pt-BR/reference/system/xuser/enums/xuserstate.md).

Para monitorar alterações no estado ou nas informações de um usuário, chame a função [XUserRegisterForChangeEvent](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xuserregisterforchangeevent.md). A função assina uma enumeração [XUserChangeEvent](https://docs.xbox.com/pt-BR/reference/system/xuser/enums/xuserchangeevent.md).

## 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](https://docs.xbox.com/pt-BR/reference/system/xuser/xuser_members.md)

[XUserState](https://docs.xbox.com/pt-BR/reference/system/xuser/enums/xuserstate.md)

[XUserRegisterForChangeEvent](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xuserregisterforchangeevent.md)

[XUserChangeEvent](https://docs.xbox.com/pt-BR/reference/system/xuser/enums/xuserchangeevent.md)


## Related topics

- [XUserState](https://docs.xbox.com/pt-BR/reference/system/xuser/enums/xuserstate.md)
- [XUserGetMaxUsers](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xusergetmaxusers.md)
- [XUserGetGamertag](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xusergetgamertag.md)
- [XUserGetLocalId](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xusergetlocalid.md)
- [Identidade do usuário e XUser](https://docs.xbox.com/pt-BR/build/core-features/common/user/player-identity-xuser.md)