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

# GetConsole

> IXtfConsoleManager::GetConsole 메서드

# IXtfConsoleManager::GetConsole 메서드

[IXtfConsoleManager](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md) 인스턴스에서 지정된 이름을 가진 개발 콘솔에 대한 정보를 가져옵니다.

## 구문

```cpp theme={null}
public:
HRESULT GetConsole(
         LPCWSTR pszAlias,
         PXTFCONSOLEDATA pConsoleData
)  
```

### 매개 변수

*pszAlias*\
형식: LPCWSTR

정보를 가져올 콘솔의 이름에 대한 포인터입니다.

*pConsoleData*\
형식: PXTFCONSOLEDATA

개발 콘솔에 대한 정보가 포함된 [XTFCONSOLEDATA](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolemanager/structures/xtfconsoledata-xtfconsolemanager-xbox-microsoft-t.md) 구조체를 받는 포인터입니다.

### 반환 값

형식: HRESULT

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

## 설명

이 메서드는 [IXtfConsoleManager](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md) 인스턴스에서 `pszAlias`에 지정된 이름을 가진 개발 콘솔에 대한 정보를 가져옵니다. 정보는 지정된 콘솔의 이름과 도구 IP 주소가 포함된 [XTFCONSOLEDATA](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolemanager/structures/xtfconsoledata-xtfconsolemanager-xbox-microsoft-t.md) 구조체로 `pConsoleData`에 반환됩니다.

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

## 요구 사항

**헤더:** xtfconsolemanager.h

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

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

## 함께 보기

[IXtfConsoleManager::EnumerateConsoles 메서드](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/enumerateconsoles-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

- [EnumerateConsoles](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/enumerateconsoles-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)
- [OnConsoleFound](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolemanager/classes/IXtfEnumerateConsolesCallback/methods/onconsolefound-ixtfenumerateconsolescallback-xtfconsolemanager-xbox-mi.md)
- [AddConsole](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/addconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)
- [IXtfConsoleManager 인터페이스 (인터페이스 콘텐츠)](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md)
- [XTFCONSOLEDATA](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolemanager/structures/xtfconsoledata-xtfconsolemanager-xbox-microsoft-t.md)