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

# ListUsers

> IXtfUserClient::ListUsers

# IXtfUserClient::ListUsers

현재 이 콘솔과 연결된 모든 사용자의 목록을 반환합니다.

## Syntax

```cpp theme={null}
public:
HRESULT ListUsers(
         XTF_USER_DATA **ppUserData,
         UINT32 *pCount
)  
```

### Parameters

*ppUserData*\
Type: XTF\_USER\_DATA \*\*

성공적으로 반환되면, 콘솔과 현재 연결된 사용자를 설명하는 [XTF\_USER\_DATA](https://docs.xbox.com/ko/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t.md) 객체의 배열을 가리킵니다.

*pCount*\
Type: UINT32 \*

성공적으로 반환되면, *ppUserData* 배열의 요소 개수입니다.

### Return value

Type: HRESULT

HRESULT 성공 또는 오류 코드.

## Remarks

호출 코드는 `CoTaskMemFree`를 사용하여 *ppUserData*와 관련된 메모리를 해제해야 합니다.

사용자가 후원(게스트) 사용자인 경우, [XTF\_USER\_DATA](https://docs.xbox.com/ko/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t.md) 객체의 `szEmailAddress` 값은 빈 문자열이며, `szGamertag`는 후원 사용자의 게이머태그에서 파생됩니다.

사용자가 이 콘솔에 한 번도 로그인한 적이 없는 경우, `szGamertag`는 빈 문자열입니다.

이 콘솔에 사용자를 추가하려면 [AddUser](https://docs.xbox.com/ko/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m.md)를 사용하세요. 게스트 사용자를 추가하려면 [AddSponsoredUser](https://docs.xbox.com/ko/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/addsponsoreduser-ixtfuserclient-xtfuser-xbox-windows-m.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

- [XTF_USER_DATA](https://docs.xbox.com/ko/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t.md)
- [PairControllerWithUser](https://docs.xbox.com/ko/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [PairControllerWithUserId](https://docs.xbox.com/ko/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient 인터페이스(인터페이스 목차)](https://docs.xbox.com/ko/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md)
- [ListUsersEx](https://docs.xbox.com/ko/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/ixtfuserclient_listusersex.md)