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

# AddConsole

> IXtfConsoleManager::AddConsole 메서드

# IXtfConsoleManager::AddConsole 메서드

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

## 구문

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

### 매개 변수

*pszAlias*\
형식: LPCWSTR

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

*pszAddress*\
형식: LPCWSTR

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

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

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

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

### 반환 값

형식: HRESULT

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

## 설명

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

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

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

## 요구 사항

**헤더:** xtfconsolemanager.h

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

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

## 함께 보기

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


## Related topics

- [OnAddConsole](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onaddconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft.md)
- [OnChangedDefaultConsole](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onchangeddefaultconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox.md)
- [IXtfConsoleManager 인터페이스 (인터페이스 콘텐츠)](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md)
- [XtfGetSavedConsoleAddress](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfgetsavedconsoleaddress-xtfapi-xbox-windows-m.md)
- [XtfGetDefaultAddress](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolemanager/methods/xtfgetdefaultaddress-xtfconsolemanager-xbox-windows-m.md)