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

# IXtfConsoleControlClient::ShutdownConsole

> IXtfConsoleControlClient::ShutdownConsole

# IXtfConsoleControlClient::ShutdownConsole

開発コンソールをシャットダウンします。

<a id="syntaxSection" />

## 構文

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

<a id="parametersSection" />

### パラメーター

*dwFlags*\
型: DWORD

開発コンソールのシャットダウン方法を指定するフラグのビット単位の OR の組み合わせです。使用可能なフラグを次の表に示します。

| 値          | 定数                              | 説明                                         |
| ---------- | ------------------------------- | ------------------------------------------ |
| 0x00000001 | XTFSHUTDOWN\_REBOOT             | 開発コンソールをシャットダウンして再起動します。                   |
| 0x00000002 | XTFSHUTDOWN\_POWER\_MODE\_AWARE | コンソールの電源モード設定に従って、開発コンソールをシャットダウンして再起動します。 |

<a id="retvalSection" />

### 戻り値

型: HRESULT

成功した場合は `S_OK` を返します。それ以外の場合は HRESULT エラー コードを返します。

<a id="remarksSection" />

## 解説

この関数は、`dwFlags` で指定したフラグの組み合わせに応じて、現在の開発コンソールをシャットダウンします。関数が呼び出された時点でシステムがシャットダウン要求を受け入れる準備ができていない場合、この関数には再試行ロジックが含まれています。たとえば、System OS にアクセスできない場合は、フォールバックとして Host OS を使用してコンソールをシャットダウンしようとします。関数は、成功するか、5 分後にタイムアウトしてエラーを返すまで、コンソールのシャットダウンを試行し続けます。

XBOX Tools Framework (XTF) を使用したコンソールのシャットダウンと再起動の詳細については、[Reboot (xbreboot.exe) (NDA topic)](/tools/tools-console/commandlinetools/xbreboot) を参照してください。

<a id="requirementsSection" />

## 要件

**ヘッダー:** xtfconsolecontrol.h

**ライブラリ:** xtfconsolecontrol.lib

**サポートされるプラットフォーム:** Windows (XBOX コンソール ツール用)

<a id="seealsoSection" />

## 関連項目

[IXtfConsoleControlClient](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient)\
[XtfConsoleControl](/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members)
