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 realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Las funciones InitiateSystemShutdown e 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 AbortSystemShutdown impide el apagado, el sistema muestra el cuadro de diálogo a los usuarios que les informan de que el servidor ya no se está apagando.
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 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 más información, consulte 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 Convenciones para prototipos de función.
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] |
| Plataforma de destino | Windows |
| Encabezado | winreg.h (incluye Windows.h) |
| Library | Advapi32.lib |
| Archivo DLL | Advapi32.dll |