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

# AddSponsoredUser

> IXtfUserClient::AddSponsoredUser

# IXtfUserClient::AddSponsoredUser

Adiciona um usuário convidado.

## Sintaxe

```cpp theme={null}
public:
HRESULT AddSponsoredUser(
         UINT32 *pUserId
)  
```

### Parâmetros

*pUserId*\
Tipo: UINT32 \*

Após a conclusão bem-sucedida, aponta para a ID de usuário do usuário convidado.

### Valor retornado

Tipo: HRESULT

Código de sucesso ou de erro HRESULT.

## Comentários

Os usuários convidados, também conhecidos como *convidados patrocinados*, são associados a uma conta que já está conectada. Quando seu código chama esse método, o sistema usa o primeiro usuário conectado da lista como patrocinador e continua a usar esse usuário para todos os usuários patrocinados subsequentes. Se o usuário selecionado se desconectar, todos os usuários patrocinados serão desconectados nesse momento.

> [!NOTE]
>
> Ao contrário da interface do usuário usada para adicionar um usuário patrocinado, esse método não tem acesso à configuração de privacidade do XBOX Live nem às configurações de segurança online ao fazer a seleção.

Para adicionar um usuário que não seja convidado, use [AddUser](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m.md).

Para obter mais informações sobre usuários convidados, confira [Visão geral de usuários convidados](https://docs.xbox.com/pt-BR/build/core-features/common/user/users-guest-overview.md).

## Requisitos

**Cabeçalho:** xtfuser.h

**Biblioteca:** xtfuser.lib

**Plataformas com suporte:** Windows (para ferramentas de console XBOX)

## Confira também

[Interface IXtfUserClient](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md)


## Related topics

- [ListUsers](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/listusers-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [Interface IXtfUserClient (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md)
- [AddUser](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [add_local_user](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_local_user.md)
- [add_remote_user](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_remote_user.md)