> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.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\*](/pt-BR/reference/system/xuser/enums/xuserstate)

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](/pt-BR/reference/errorcodes).

## Comentários

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

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

## 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](/pt-BR/reference/system/xuser/xuser_members)

[XUserState](/pt-BR/reference/system/xuser/enums/xuserstate)

[XUserRegisterForChangeEvent](/pt-BR/reference/system/xuser/functions/xuserregisterforchangeevent)

[XUserChangeEvent](/pt-BR/reference/system/xuser/enums/xuserchangeevent)


## Related topics

- [XUserGetState](/reference/system/xuser/functions/xusergetstate.md)
- [XUserState](/reference/system/xuser/enums/xuserstate.md)
- [XUserGetMaxUsers](/reference/system/xuser/functions/xusergetmaxusers.md)