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

> IXtfUserClient::ListUsers

# IXtfUserClient::ListUsers

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

<a id="syntaxSection" />

## Syntax

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

<a id="ID4EG" />

<a id="parametersSection" />

### Parameters

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

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

*pCount*\
Type: UINT32 \*

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

<a id="ID4EP" />

<a id="retvalSection" />

### Return value

Type: HRESULT

HRESULT 성공 또는 오류 코드.

<a id="remarks" />

<a id="remarksSection" />

## Remarks

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

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

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

이 콘솔에 사용자를 추가하려면 [AddUser](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m)를 사용하세요. 게스트 사용자를 추가하려면 [AddSponsoredUser](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/addsponsoreduser-ixtfuserclient-xtfuser-xbox-windows-m)를 사용하세요.

<a id="requirementsSection" />

## Requirements

**Header:** xtfuser.h

**Library:** xtfuser.lib

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

<a id="seealsoSection" />

## See also

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


## Related topics

- [XTF_USER_DATA](/ko/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t.md)
- [IXtfUserClient::ListUsersEx](/ko/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/ixtfuserclient_listusersex.md)
- [IXtfUserClient::PairControllerWithUser Method](/ko/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::PairControllerWithUserId Method](/ko/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::DeleteUser](/ko/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/deleteuser-ixtfuserclient-xtfuser-xbox-windows-m.md)