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

添加来宾用户。

## 语法

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

### 参数

*pUserId*\
类型：UINT32 \*

成功完成后，指向来宾用户的用户 ID。

### 返回值

类型：HRESULT

HRESULT 成功或错误代码。

## 备注

来宾用户（也称为*受赞助的来宾*）与已登录的帐户关联。当你的代码调用此方法时，系统会使用列表中第一个已登录的用户作为赞助者，并对所有后续受赞助的用户继续使用该用户。如果所选用户注销，则所有受赞助的用户也将同时注销。

> [!NOTE]
>
> 与用于添加受赞助来宾的 UI 不同，此方法在做出选择时无权访问 XBOX Live 隐私设置和在线安全设置。

若要添加非来宾用户，请使用 [AddUser](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m.md)。

有关来宾用户的详细信息，请参阅[来宾用户概述](https://docs.xbox.com/zh-CN/build/core-features/common/user/users-guest-overview.md)。

## 要求

**头文件：** xtfuser.h

**库：** xtfuser.lib

**支持的平台：** Windows（用于 XBOX 主机工具）

## 另请参阅

[IXtfUserClient interface](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md)


## Related topics

- [ListUsers](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/listusers-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient 接口（接口内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md)
- [访客用户概述](https://docs.xbox.com/zh-CN/build/core-features/common/user/users-guest-overview.md)
- [AddUser](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [add_local_user](https://docs.xbox.com/zh-CN/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_local_user.md)