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

# XtfCreateConsoleControlClient

> XtfCreateConsoleControlClient

# XtfCreateConsoleControlClient

지정된 주소를 가진 [IXtfConsoleControlClient](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient) 인터페이스의 새 인스턴스를 초기화합니다.

<a id="syntaxSection" />

## 구문

```cpp theme={null}
HRESULT XtfCreateConsoleControlClient(
         LPCWSTR pszAddress,
         REFIID riid,
         void **ppvObject
)  
```

<a id="parametersSection" />

### 매개 변수

*pszAddress*\
형식: LPCWSTR

새 [IXtfConsoleControlClient](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient) 인스턴스에 사용할 개발 콘솔의 도구 IP 주소에 대한 포인터입니다.

*riid*\
형식: REFIID

새로 생성된 [IXtfConsoleControlClient](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient) 인스턴스의 인스턴스 식별자를 받는 포인터입니다.

*ppvObject*\
형식: void\*\*

새로 생성된 [IXtfConsoleControlClient](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient) 인스턴스에 대한 참조를 받는 포인터입니다.

<a id="retvalSection" />

### 반환 값

형식: HRESULT

성공하면 `S_OK`를 반환하고, 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

<a id="remarksSection" />

## 설명

이 함수는 `pszAddress`에 지정된 콘솔에 [IXtfConsoleControlClient](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient) 새 인스턴스를 생성하고 연결합니다. 그런 다음 새 `IXtfConsoleControlClient` 인스턴스를 사용하여 구성 설정, 시스템 시간 또는 현재 실행 중인 프로세스와 같은 정보를 콘솔에서 검색할 수 있습니다. 또한 구성 값을 설정하거나, 스택 덤프를 생성하거나, 콘솔을 종료할 수도 있습니다.

XBOX Tools Framework(XTF)와 같은 사용 가능한 도구 및 자동화 API에 대한 자세한 내용은 [도구 및 자동화 API(NDA 항목)](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/debug/atoc-api-tools-dev-env)를 참조하세요.

<a id="requirementsSection" />

## 요구 사항

**헤더:** xtfconsolecontrol.h

**라이브러리:** xtfconsolecontrol.lib

**지원 플랫폼:** Windows(XBOX 콘솔 도구용)

<a id="seealsoSection" />

## 함께 보기

[XtfConsoleControl](/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members)\
[XBOX Tools Framework](/reference/tools/xtf/atoc-xbox-tools-framework)


## Related topics

- [IXtfConsoleControlClient](/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)
- [IXtfConsoleControlClient::GetRunningProcesses](/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getrunningprocesses.md)
- [IXtfConsoleControlClient::ShutdownConsole](/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_shutdownconsole.md)
- [IXtfConsoleControlClient::UpdatesPending](/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_updatespending.md)
- [IXtfConsoleControlClient::SetConfigValue](/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_setconfigvalue.md)