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

# IXtfConsoleManager::AddConsole 메서드

> IXtfConsoleManager::AddConsole 메서드

# IXtfConsoleManager::AddConsole 메서드

[IXtfConsoleManager](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t) 인스턴스에 개발 콘솔을 추가합니다.

<a id="syntaxSection" />

## 구문

```cpp theme={null}
public:
HRESULT AddConsole(
         LPCWSTR pszAlias,
         LPCWSTR pszAddress,
         XTF_ADD_CONSOLE_FLAGS dwFlags
)  
```

<a id="parametersSection" />

### 매개 변수

*pszAlias*\
형식: LPCWSTR

추가할 콘솔의 이름에 대한 포인터입니다.

*pszAddress*\
형식: LPCWSTR

추가할 콘솔의 도구 IP 주소에 대한 포인터입니다.

*dwFlags*\
형식: XTF\_ADD\_CONSOLE\_FLAGS

인스턴스에 콘솔을 추가하는 방법을 지정하는 비트별 OR 플래그의 조합입니다. 다음 표에서는 사용 가능한 플래그를 설명합니다.

| 값   | 매크로                                  | 설명                                  |
| --- | ------------------------------------ | ----------------------------------- |
| 0x0 | XTF\_ADD\_CONSOLE\_FLAGS\_NONE       | 지정된 플래그가 없습니다.                      |
| 0x1 | XTF\_ADD\_CONSOLE\_FLAGS\_SETDEFAULT | 개발 콘솔을 추가한 후 이 PC의 기본 개발 콘솔로 설정합니다. |

<a id="retvalSection" />

### 반환 값

형식: HRESULT

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

<a id="remarksSection" />

## 설명

이 메서드는 `pszAddress`에 지정된 개발 콘솔을 `pszAlias`에 지정된 이름을 사용하여 [IXtfConsoleManager](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t) 인스턴스에 추가합니다. `dwFlags`에 `XTF_ADD_CONSOLE_FLAGS_SETDEFAULT`가 지정되면 개발 콘솔이 이 PC의 기본 개발 콘솔로도 설정됩니다. 기본 개발 콘솔에 대한 자세한 내용은 [IXtfConsoleManager::SetDefaultConsole 메서드](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/setdefaultconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m)를 참조하세요.

이 메서드가 성공적으로 호출된 후 `IXtfConsoleManager` 인스턴스는 연결된 [IXtfConsoleManagerCallback](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft-t) 인스턴스의 [OnAddConsole](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onaddconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft) 콜백 메서드를 호출합니다. `dwFlags`에 `XTF_ADD_CONSOLE_FLAGS_SETDEFAULT`가 지정된 경우 연결된 `IXtfConsoleManagerCallback` 인스턴스의 [OnChangedDefaultConsole](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onchangeddefaultconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox) 콜백 메서드도 호출됩니다.

개발 콘솔을 연결하고 쿼리하는 방법에 대한 자세한 내용은 [연결(xbconnect.exe)(NDA 항목)](/tools/tools-console/commandlinetools/xbconnect)을 참조하세요.

<a id="requirementsSection" />

## 요구 사항

**헤더:** xtfconsolemanager.h

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

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

<a id="seealsoSection" />

## 함께 보기

[IXtfConsoleManager::GetConsole 메서드](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/getconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m)\
[IXtfConsoleManager::RemoveConsole 메서드](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/removeconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m)\
[IXtfConsoleManager 인터페이스](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t)\
[XtfConsoleManager](/reference/tools/xtf/xtfconsolemanager/xtfconsolemanager-xbox-microsoft-n)


## Related topics

- [IXtfConsoleManagerCallback::OnAddConsole 메서드](/ko/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onaddconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft.md)
- [IXtfConsoleManagerCallback::OnChangedDefaultConsole 메서드](/ko/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onchangeddefaultconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox.md)
- [IXtfConsoleManager::EnumerateConsoles 메서드](/ko/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/enumerateconsoles-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)
- [IXtfConsoleManager::GetConsole 메서드](/ko/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/getconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)
- [IXtfConsoleManager::RemoveConsole 메서드](/ko/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/removeconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)