> ## 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.

# XUserAddByIdWithUiResult

> XUserAddByIdWithUiResult

# XUserAddByIdWithUiResult

Recupera um identificador para o usuário criado por [XUserAddByIdWithUiAysnc](/pt-BR/reference/system/xuser/functions/xuseraddbyidwithuiasync).
Esta função só deve ser usada em resposta a um convite de jogo.

## Sintaxe

```cpp theme={null}
HRESULT XUserAddByIdWithUiResult(  
         XAsyncBlock* async,  
         XUserHandle* newUser  
)  
```

### Parâmetros

*async*   \_Inout\_\
Tipo: [XAsyncBlock\*](/pt-BR/reference/system/xasync/structs/xasyncblock)

O [XAsyncBlock](/pt-BR/reference/system/xasync/structs/xasyncblock) enviado anteriormente para [XUserAddByIdWithUiAysnc](/pt-BR/reference/system/xuser/functions/xuseraddbyidwithuiasync).

*newUser*   \_Out\_\
Tipo: XUserHandle\*

Contém um identificador para o novo usuário.

### Valor retornado

Tipo: HRESULT

Código de sucesso ou de erro HRESULT.
Para obter uma lista de códigos de erro, consulte [Códigos de erro](/pt-BR/reference/errorcodes).

| Código de retorno | Descrição |
| - | - |
| S\_OK | A operação foi bem-sucedida. |
| E\_GAMEUSER\_USER\_NOTFOUND | O usuário especificado no XUID passado para [XUserAddByIdWithUiAysnc](/pt-BR/reference/system/xuser/functions/xuseraddbyidwithuiasync) não está mais conectado ao dispositivo. |

## Comentários

Para obter mais detalhes sobre como usar esta função, consulte [XUserAddByIdWithUiAysnc](/pt-BR/reference/system/xuser/functions/xuseraddbyidwithuiasync).

## 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)\
[XUserCloseHandle](/pt-BR/reference/system/xuser/functions/xuserclosehandle)


## Related topics

- [XUserAddByIdWithUiResult](/reference/system/xuser/functions/xuseraddbyidwithuiresult.md)
- [XUserAddByIdWithUiAsync](/reference/system/xuser/functions/xuseraddbyidwithuiasync.md)