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

게스트 사용자를 추가합니다.

## Syntax

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

### Parameters

*pUserId*\
Type: UINT32 \*

성공적으로 완료되면 게스트 사용자의 사용자 ID를 가리킵니다.

### Return value

Type: HRESULT

HRESULT 성공 또는 오류 코드.

## Remarks

*sponsored guests*라고도 알려진 게스트 사용자는 이미 로그인한 계정과 연결되어 있습니다. 코드가 이 메서드를 호출하면 시스템은 목록에서 첫 번째로 로그인한 사용자를 스폰서로 사용하고 이후의 모든 게스트 사용자에 대해 계속해서 해당 사용자를 사용합니다. 선택된 사용자가 로그아웃하면 그 시점에 모든 게스트 사용자가 로그아웃됩니다.

> [!NOTE]
>
> 게스트 사용자를 추가하는 데 사용되는 UI와 달리, 이 메서드는 선택 시 XBOX Live 개인정보 설정과 온라인 안전 설정에 접근할 수 없습니다.

게스트가 아닌 사용자를 추가하려면 [AddUser](https://docs.xbox.com/ko/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m.md)를 사용합니다.

게스트 사용자에 대한 자세한 내용은 [Guest Users Overview](https://docs.xbox.com/ko/build/core-features/common/user/users-guest-overview.md)를 참조하세요.

## Requirements

**Header:** xtfuser.h

**Library:** xtfuser.lib

**Supported platforms:** Windows(XBOX 콘솔 도구용)

## See also

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


## Related topics

- [ListUsers](https://docs.xbox.com/ko/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/listusers-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient 인터페이스(인터페이스 목차)](https://docs.xbox.com/ko/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md)
- [게스트 사용자 개요](https://docs.xbox.com/ko/build/core-features/common/user/users-guest-overview.md)
- [AddUser](https://docs.xbox.com/ko/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [add_local_user](https://docs.xbox.com/ko/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_local_user.md)