Códigos de motivo del apagado del sistema

  • Artículo

Las funciones ExitWindowsEx e InitiateSystemShutdownEx usan los códigos de motivo del apagado en el parámetro dwReason .

El sistema procesará un máximo de MAX_NUM_REASONS códigos de motivo. MAX_NUM_REASONS se define en reason.h.

A continuación se muestran las marcas de motivo principales. Indican el tipo de problema general.

Constante o valor Descripción
SHTDN_REASON_MAJOR_APPLICATION
0x00040000
 Problema de la aplicación.
SHTDN_REASON_MAJOR_HARDWARE
0x00010000
 Incidencia de hardware.
SHTDN_REASON_MAJOR_LEGACY_API
0x00070000
 La función InitiateSystemShutdown se usó en lugar de InitiateSystemShutdownEx.
SHTDN_REASON_MAJOR_OPERATINGSYSTEM
0x00020000
 Problema del sistema operativo.
SHTDN_REASON_MAJOR_OTHER
0x00000000
 Otro problema.
SHTDN_REASON_MAJOR_POWER
0x00060000
 Error de alimentación.
SHTDN_REASON_MAJOR_SOFTWARE
0x00030000
 Problema de software.
SHTDN_REASON_MAJOR_SYSTEM
0x00050000
 Error del sistema.

A continuación se muestran las marcas de motivo secundarias. Modifican la marca de motivo principal especificada. Puede usar cualquier motivo menor junto con cualquier motivo importante, pero algunas combinaciones no tienen sentido.

Constante o valor Descripción
SHTDN_REASON_MINOR_BLUESCREEN
0x0000000F
 Evento de bloqueo de pantalla azul.
SHTDN_REASON_MINOR_CORDUNPLUGGED
0x0000000b
 Desenchufado.
SHTDN_REASON_MINOR_DISK
0x00000007
 disco.
SHTDN_REASON_MINOR_ENVIRONMENT
0x0000000c
 Entorno.
SHTDN_REASON_MINOR_HARDWARE_DRIVER
0x0000000d
 Conductor.
SHTDN_REASON_MINOR_HOTFIX
0x00000011
 Corrección activa.
SHTDN_REASON_MINOR_HOTFIX_UNINSTALL
0x00000017
 Desinstalación de corrección activa.
SHTDN_REASON_MINOR_HUNG
0x00000005
 Insensible.
SHTDN_REASON_MINOR_INSTALLATION
0x00000002
 Instalación.
SHTDN_REASON_MINOR_MAINTENANCE
0x00000001
 Mantenimiento.
SHTDN_REASON_MINOR_MMC
0x00000019
 Problema de MMC.
SHTDN_REASON_MINOR_NETWORK_CONNECTIVITY
0x00000014
 Conectividad de red.
SHTDN_REASON_MINOR_NETWORKCARD
0x00000009
 Tarjeta de red.
SHTDN_REASON_MINOR_OTHER
0x00000000
 Otro problema.
SHTDN_REASON_MINOR_OTHERDRIVER
0x0000000e
 Otro evento de controlador.
SHTDN_REASON_MINOR_POWER_SUPPLY
0x0000000a
 Fuente de alimentación.
SHTDN_REASON_MINOR_PROCESSOR
0x00000008
 Procesador.
SHTDN_REASON_MINOR_RECONFIG
0x00000004
 Reconfigurar.
SHTDN_REASON_MINOR_SECURITY
0x00000013
 Problema de seguridad.
SHTDN_REASON_MINOR_SECURITYFIX
0x00000012
 Revisión de seguridad.
SHTDN_REASON_MINOR_SECURITYFIX_UNINSTALL
0x00000018
 Desinstalación de revisiones de seguridad.
SHTDN_REASON_MINOR_SERVICEPACK
0x00000010
 Service Pack.
SHTDN_REASON_MINOR_SERVICEPACK_UNINSTALL
0x00000016
 Desinstalación de Service Pack.
SHTDN_REASON_MINOR_TERMSRV
0x00000020
 Terminal Services.
SHTDN_REASON_MINOR_UNSTABLE
0x00000006
 Inestable.
SHTDN_REASON_MINOR_UPGRADE
0x00000003
 Actualización.
SHTDN_REASON_MINOR_WMI
0x00000015
 Problema de WMI.

Las marcas opcionales siguientes proporcionan información adicional sobre el evento.

Constante o valor Descripción
SHTDN_REASON_FLAG_USER_DEFINED
0x40000000
 El usuario define el código de motivo. Para obtener más información, vea Definición de un código de motivo personalizado.
Si esta marca no está presente, el sistema define el código de motivo.
SHTDN_REASON_FLAG_PLANNED
0x80000000
 Se planeó el apagado. El sistema genera un archivo de datos de estado del sistema (SSD). Este archivo contiene información de estado del sistema, como los procesos, los subprocesos, el uso de memoria y la configuración.
Si esta marca no está presente, el apagado no se ha planeado. Las opciones de notificación e informes se controlan mediante un conjunto de directivas. Por ejemplo, después de iniciar sesión, el sistema muestra un cuadro de diálogo que informa del apagado no planeado si se ha habilitado la directiva. Solo se crea un archivo SSD si la directiva SSD está habilitada en el sistema. El administrador puede usar Informe de errores de Windows para enviar los datos ssd a una ubicación central o a Microsoft.

Comentarios

El sistema reconoce las combinaciones siguientes. La tabla indica la cadena que se muestra en el Seguimiento de eventos de apagado y proporciona una descripción más detallada. La cadena predeterminada es "No se encontró ningún título por este motivo".

Combinación Descripción
SHTDN_REASON_MAJOR_APPLICATION | SHTDN_REASON_MINOR_HUNG "Aplicación: no responde" Reinicio o apagado no planeado para solucionar problemas de una aplicación que no responde.
SHTDN_REASON_MAJOR_APPLICATION | SHTDN_REASON_MINOR_INSTALLATION | SHTDN_REASON_FLAG_PLANNED "Aplicación: Instalación (planeada)" Un reinicio planeado o apagado para realizar la instalación de la aplicación.
SHTDN_REASON_MAJOR_APPLICATION | SHTDN_REASON_MINOR_MAINTENANCE "Aplicación: Mantenimiento (no planeado)" Reinicio o apagado no planeado para atender una aplicación.
SHTDN_REASON_MAJOR_APPLICATION | SHTDN_REASON_MINOR_MAINTENANCE | SHTDN_REASON_FLAG_PLANNED "Aplicación: Mantenimiento (planeado)" Reinicio planeado o apagado para realizar el mantenimiento planeado en una aplicación.
SHTDN_REASON_MAJOR_APPLICATION | SHTDN_REASON_MINOR_UNSTABLE "Aplicación: Inestable" Reinicio o apagado no planeado para solucionar problemas de una aplicación inestable.
SHTDN_REASON_MAJOR_HARDWARE | SHTDN_REASON_MINOR_INSTALLATION "Hardware: Instalación (no planeada)" Reinicio o apagado no planeado para iniciar o completar la instalación de hardware.
SHTDN_REASON_MAJOR_HARDWARE | SHTDN_REASON_MINOR_INSTALLATION | SHTDN_REASON_FLAG_PLANNED "Hardware: Instalación (planeada)" Un reinicio o apagado planeado para comenzar o completar la instalación de hardware.
SHTDN_REASON_MAJOR_HARDWARE | SHTDN_REASON_MINOR_MAINTENANCE "Hardware: Mantenimiento (no planeado)" Reinicio o apagado no planeado para el hardware del servicio en el sistema.
SHTDN_REASON_MAJOR_HARDWARE | SHTDN_REASON_MINOR_MAINTENANCE | SHTDN_REASON_FLAG_PLANNED "Hardware: Mantenimiento (planeado)" Un reinicio planeado o apagado para el hardware del servicio en el sistema.
SHTDN_REASON_MAJOR_LEGACY_API "Apagado de LA API heredada" Este apagado se inició mediante la función InitiateSystemShutdown heredada. Las aplicaciones deben usar la función InitiateSystemShutdownEx .
SHTDN_REASON_MAJOR_OPERATINGSYSTEM | SHTDN_REASON_MINOR_HOTFIX "Sistema operativo: corrección activa (no planeada)" Un reinicio o apagado no planeado para instalar una corrección activa.
SHTDN_REASON_MAJOR_OPERATINGSYSTEM | SHTDN_REASON_MINOR_HOTFIX | SHTDN_REASON_FLAG_PLANNED "Sistema operativo: corrección activa (planeada)" Un reinicio planeado o apagado para instalar una corrección activa.
SHTDN_REASON_MAJOR_OPERATINGSYSTEM | SHTDN_REASON_MINOR_RECONFIG "Sistema operativo: Reconfiguración (no planeada)" Reinicio o apagado no planeado para cambiar la configuración del sistema operativo.
SHTDN_REASON_MAJOR_OPERATINGSYSTEM | SHTDN_REASON_MINOR_RECONFIG | SHTDN_REASON_FLAG_PLANNED "Sistema operativo: Reconfiguración (planeada)" Reinicio o apagado planeado para cambiar la configuración del sistema operativo.
SHTDN_REASON_MAJOR_OPERATINGSYSTEM | SHTDN_REASON_MINOR_SECURITYFIX "Sistema operativo: corrección de seguridad (no planeada)" Reinicio o apagado no planeado para instalar una revisión de seguridad.
SHTDN_REASON_MAJOR_OPERATINGSYSTEM | SHTDN_REASON_MINOR_SECURITYFIX | SHTDN_REASON_FLAG_PLANNED "Sistema operativo: corrección de seguridad (planeada)" Un reinicio planeado o apagado para instalar una revisión de seguridad.
SHTDN_REASON_MAJOR_OPERATINGSYSTEM | SHTDN_REASON_MINOR_SERVICEPACK | SHTDN_REASON_FLAG_PLANNED "Sistema operativo: Service Pack (planeado)" Un reinicio o apagado planeado para instalar un Service Pack.
SHTDN_REASON_MAJOR_OPERATINGSYSTEM | SHTDN_REASON_MINOR_UPGRADE | SHTDN_REASON_FLAG_PLANNED "Sistema operativo: Actualización (planeada)" Un reinicio planeado o apagado para actualizar la configuración del sistema operativo.
SHTDN_REASON_MAJOR_OTHER | SHTDN_REASON_MINOR_OTHER "Other (Unplanned)" Un apagado o reinicio no planeado.
SHTDN_REASON_MAJOR_OTHER | SHTDN_REASON_MINOR_OTHER | SHTDN_REASON_FLAG_PLANNED "Otro (planeado)" Un apagado o reinicio planeado.
SHTDN_REASON_MAJOR_OTHER | SHTDN_REASON_MINOR_HUNG "Otro error: Sistema no responde" El sistema se convirtió en no responde.
SHTDN_REASON_MAJOR_POWER | SHTDN_REASON_MINOR_CORDUNPLUGGED "Power Failure: Cord Unplugged" El equipo estaba desconectado.
SHTDN_REASON_MAJOR_POWER | SHTDN_REASON_MINOR_ENVIRONMENT "Error de energía: entorno" Hubo una interrupción de la alimentación.
SHTDN_REASON_MAJOR_SYSTEM | SHTDN_REASON_MINOR_BLUESCREEN "Error del sistema: Error de detención" El equipo mostró un evento de bloqueo de pantalla azul.
SHTDN_REASON_MAJOR_SYSTEM | SHTDN_REASON_MINOR_NETWORK_CONNECTIVITY "Pérdida de conectividad de red (no planeada)" El equipo debe apagarse debido a un problema de conectividad de red.
SHTDN_REASON_MAJOR_SYSTEM | SHTDN_REASON_MINOR_SECURITY "Problema de seguridad" El equipo debe apagarse debido a un problema de seguridad.

 

También puede definir sus propios motivos de apagado y agregarlos al registro. Cada código de motivo debe almacenarse como un valor del Registro en la clave siguiente:HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Reliability\UserDefined\<default_system_language_ID>

Esta clave contiene nombres de valor de la siguiente forma: xxxxx; nnn; nnnnn. Los puntos y coma delimitan los componentes de un nombre de valor.

Xxxxx

Uno a cinco de los siguientes marcadores de control (no se puede usar ningún otro carácter).

Marca Descripción
P Apagado planeado; de lo contrario, un apagado no planeado.
C Se requiere un comentario. Esta marca debe usarse con S.
B Se requiere un identificador. Esta marca debe usarse con D.
S Muestra el cuadro de diálogo de apagado esperado. Se deben usar S, D o S y D.
D Muestra el cuadro de diálogo de apagado inesperado. Se deben usar S, D o S y D.

 

El orden en que se usan las marcas no es importante. Por ejemplo, CSP indica un apagado planeado donde se muestra el cuadro de diálogo de apagado esperado y se requiere un comentario.

Nnn

Razón principal. Este componente debe ser un número en el intervalo 64-255. El intervalo 0-63 está reservado para su uso por el sistema.

nnnnn

Motivo menor. Este componente debe estar en el intervalo 0-65535.

Los motivos personalizados se ordenan en la interfaz de usuario por el número de motivo principal y, a continuación, por número de motivo menor. Ninguna de las dos razones personalizadas puede usar las mismas razones principales y menores, a menos que se planee una y la otra no esté planeada. De lo contrario, el sistema usará la primera instancia y omitirá los demás.

Los datos de cada valor del Registro son dos cadenas, separadas por \n\r. La primera cadena es una cadena de título que se mostrará en el cuadro de diálogo de apagado y se escribirá en el registro de eventos. El tamaño máximo es de 64 caracteres. Las cadenas de título deben ser únicas. Los títulos personalizados no pueden coincidir con los títulos estándar definidos por el sistema u otro título personalizado. La segunda cadena es una cadena de descripción que se va a mostrar en el cuadro de diálogo de apagado; es opcional. El tamaño máximo es de 256 caracteres.

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows XP [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible
 Windows Server 2003 [aplicaciones de escritorio | Aplicaciones para UWP]
Encabezado
Reason.h