Función AbortSystemShutdownA (winreg.h)

Detiene un apagado del sistema que se ha iniciado.

Sintaxis

BOOL AbortSystemShutdownA(
  [in, optional] LPSTR lpMachineName
);

Parámetros

[in, optional] lpMachineName

Nombre de red del equipo donde se va a detener el apagado. Si lpMachineName es NULL o una cadena vacía, la función detiene el apagado en el equipo local.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es distinto de cero.

Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Observaciones

Las funciones InitiateSystemShutdown y InitiateSystemShutdownEx muestran un cuadro de diálogo que notifica al usuario que el sistema está apagando. Durante el período de tiempo de espera de apagado, la función AbortSystemShutdown puede impedir que el sistema se apague.

Windows Server 2003 y Windows XP con SP1: Si el equipo que se va a apagar es un servidor de Terminal Services, el sistema muestra un cuadro de diálogo a todos los usuarios locales y remotos que les advierten de que se ha iniciado el apagado. Si el apagado lo impide abortSystemShutdown, el sistema muestra el cuadro de diálogo a los usuarios que les informan de que el servidor ya no se apaga.

Para impedir que el equipo local se apague, el proceso de llamada debe tener el privilegio SE_SHUTDOWN_NAME. Para detener el apagado de un equipo remoto, el proceso de llamada debe tener el privilegio SE_REMOTE_SHUTDOWN_NAME en el equipo remoto. De forma predeterminada, los usuarios pueden habilitar el privilegio de SE_SHUTDOWN_NAME en el equipo en el que han iniciado sesión y los administradores pueden habilitar el privilegio de SE_REMOTE_SHUTDOWN_NAME en equipos remotos. Para obtener más información, vea En ejecución con privilegios especiales.

Entre los motivos comunes del error se incluyen un nombre de equipo no válido, un equipo inaccesible o privilegios insuficientes.

Ejemplos

Para obtener un ejemplo, vea Mostrar el cuadro de diálogo Apagar.

Nota

El encabezado winreg.h define AbortSystemShutdown como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [aplicaciones de escritorio | Aplicaciones para UWP]
servidor mínimo admitido	Windows Server 2003 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de	Windows
encabezado de	winreg.h (incluya Windows.h)
biblioteca de	Advapi32.lib
DLL de	Advapi32.dll

Consulte también

InitiateSystemShutdown

apagar

funciones de apagado del sistema de