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

Apaga la consola de desarrollo.

<a id="syntaxSection" />

## Sintaxis

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

<a id="parametersSection" />

### Parámetros

*dwFlags*\
Tipo: DWORD

Una combinación OR bit a bit de marcas que especifican cómo apagar la consola de desarrollo. La tabla siguiente enumera las marcas disponibles:

| Valor      | Constante                       | Descripción                                                                                         |
| ---------- | ------------------------------- | --------------------------------------------------------------------------------------------------- |
| 0x00000001 | XTFSHUTDOWN\_REBOOT             | Apaga y reinicia la consola de desarrollo.                                                          |
| 0x00000002 | XTFSHUTDOWN\_POWER\_MODE\_AWARE | Apaga y reinicia la consola de desarrollo según la configuración del modo de energía de la consola. |

<a id="retvalSection" />

### Valor devuelto

Tipo: HRESULT

Devuelve `S_OK` si se ejecuta correctamente; de lo contrario, devuelve un código de error HRESULT.

<a id="remarksSection" />

## Comentarios

Esta función apaga la consola de desarrollo actual, según la combinación de marcas especificadas en `dwFlags`. Si el sistema no está preparado para aceptar una solicitud de apagado en el momento en que se invoca la función, la función incluye lógica de reintento, como intentar apagar la consola mediante el sistema operativo host como alternativa si no se puede acceder al sistema operativo del sistema. La función intenta apagar la consola hasta que se ejecuta correctamente o hasta que agota el tiempo de espera después de 5 minutos y devuelve un error.

Para obtener más información sobre cómo apagar y reiniciar una consola mediante XBOX Tools Framework (XTF), consulte [Reinicio (xbreboot.exe) (tema NDA)](/tools/tools-console/commandlinetools/xbreboot).

<a id="requirementsSection" />

## Requisitos

**Encabezado:** xtfconsolecontrol.h

**Biblioteca:** xtfconsolecontrol.lib

**Plataformas compatibles:** Windows (para herramientas de consola XBOX)

<a id="seealsoSection" />

## Consulte también

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


## Related topics

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