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

Shuts down the development console.

<a id="syntaxSection" />

## Syntax

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

<a id="parametersSection" />

### Parameters

*dwFlags*\
Type: DWORD

A bitwise-OR combination of flags that specify how to shut down the development console. The following table lists the available flags:

| Value      | Constant                        | Description                                                                                    |
| ---------- | ------------------------------- | ---------------------------------------------------------------------------------------------- |
| 0x00000001 | XTFSHUTDOWN\_REBOOT             | Shuts down and reboots the development console.                                                |
| 0x00000002 | XTFSHUTDOWN\_POWER\_MODE\_AWARE | Shuts down and reboots the development console according to the console's power mode settings. |

<a id="retvalSection" />

### Return value

Type: HRESULT

Returns `S_OK` if successful; otherwise, returns an HRESULT error code.

<a id="remarksSection" />

## Remarks

This function shuts down the current development console, depending on the combination of flags specified in `dwFlags`. If the system isn't ready to accept a shutdown request at the time the function is invoked, the function includes retry logic, such as attempting to shut down the console using the Host OS as a fallback if the System OS is not accessible. The function attempts to shut down the console until the function either succeeds or times out after 5 minutes and returns an error.

For more information about shutting down and rebooting a console using XBOX Tools Framework (XTF), see [Reboot (xbreboot.exe) (NDA topic)](/tools/tools-console/commandlinetools/xbreboot).

<a id="requirementsSection" />

## Requirements

**Header:** xtfconsolecontrol.h

**Library:** xtfconsolecontrol.lib

**Supported platforms:** Windows (for XBOX console tools)

<a id="seealsoSection" />

## See also

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


## Related topics

- [IXtfConsoleControlClient](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)
- [IXtfConsoleControlClient::UpdatesPending](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_updatespending.md)
- [IXtfConsoleControlClient::SetConfigValue](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_setconfigvalue.md)
- [IXtfConsoleControlClient::GetAllSettings](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings.md)
- [IXtfConsoleControlClient::GetConfigSettings](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getconfigsettings.md)
