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

# IXtfUserClient::AddSponsoredUser

> IXtfUserClient::AddSponsoredUser

# IXtfUserClient::AddSponsoredUser

Adiciona um usuário convidado.

<a id="syntaxSection" />

## Sintaxe

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

<a id="parametersSection" />

### Parâmetros

*pUserId*\
Tipo: UINT32 \*

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

<a id="retvalSection" />

### Valor retornado

Tipo: HRESULT

Código de sucesso ou de erro HRESULT.

<a id="remarksSection" />

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

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

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

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** xtfuser.h

**Biblioteca:** xtfuser.lib

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

<a id="seealsoSection" />

## Confira também

[Interface IXtfUserClient](/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t)


## Related topics

- [IXtfUserClient::ListUsers](/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/listusers-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [Método IXtfUserClient::AddUser](/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::DeleteUser](/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/deleteuser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::SigninUser](/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signinuser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::DeleteAllUsers](/pt-BR/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/deleteallusers-ixtfuserclient-xtfuser-xbox-windows-m.md)