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

# ShutdownConsole

> IXtfConsoleControlClient::ShutdownConsole

# IXtfConsoleControlClient::ShutdownConsole

개발 콘솔을 종료합니다.

## 구문

```cpp theme={null}
HRESULT ShutdownConsole(
         DWORD dwFlags
)  
```

### 매개 변수

*dwFlags*\
형식: DWORD

개발 콘솔을 종료하는 방법을 지정하는 플래그의 비트별 OR 조합입니다. 다음 표에서는 사용 가능한 플래그를 나열합니다.

| 값 | 상수 | 설명 |
| - | - | - |
| 0x00000001 | XTFSHUTDOWN\_REBOOT | 개발 콘솔을 종료하고 재부팅합니다. |
| 0x00000002 | XTFSHUTDOWN\_POWER\_MODE\_AWARE | 콘솔의 전원 모드 설정에 따라 개발 콘솔을 종료하고 재부팅합니다. |

### 반환 값

형식: HRESULT

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

## 설명

이 함수는 `dwFlags`에 지정된 플래그의 조합에 따라 현재 개발 콘솔을 종료합니다. 함수가 호출된 시점에 시스템이 종료 요청을 받아들일 준비가 되어 있지 않은 경우, 이 함수는 System OS에 액세스할 수 없는 경우 Host OS를 사용하여 콘솔을 종료하는 등의 재시도 로직을 포함합니다. 이 함수는 성공하거나 5분 후에 시간 초과되어 오류를 반환할 때까지 콘솔 종료를 시도합니다.

XBOX Tools Framework(XTF)를 사용하여 콘솔을 종료하고 재부팅하는 방법에 대한 자세한 내용은 [재부팅(xbreboot.exe)(NDA 항목)](https://docs.xbox.com/ko/tools/tools-console/commandlinetools/xbreboot.md)을 참조하세요.

## 요구 사항

**헤더:** xtfconsolecontrol.h

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

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

## 함께 보기

[IXtfConsoleControlClient](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)\
[XtfConsoleControl](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)


## Related topics

- [IXtfConsoleControlClient (인터페이스 콘텐츠)](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)
- [Shutdown Multiplayer Server](https://docs.xbox.com/api-reference/multiplayerserver/shutdown-multiplayer-server.md)
- [XtfShutdownTitleOS](https://docs.xbox.com/ko/reference/tools/xtf/xtfapi/functions/xtfshutdowntitleos-xtfapi-xbox-windows-m.md)
- [MsQuic](https://docs.xbox.com/ko/build/console-features/networking/game-mesh/msquic-intro-networking.md)
- [멀티플레이어 서버 종료](https://docs.xbox.com/ko/services/playfab/api-references/rest/multiplayer/multiplayer-server/shutdown-multiplayer-server.md)