Función SetProcessShutdownParameters (processthreadsapi.h)

Establece los parámetros de apagado para el proceso que realiza la llamada actualmente. Esta función establece un orden de apagado para un proceso en relación con los demás procesos del sistema.

Sintaxis

BOOL SetProcessShutdownParameters(
  [in] DWORD dwLevel,
  [in] DWORD dwFlags
);

Parámetros

[in] dwLevel

Prioridad de apagado de un proceso en relación con otros procesos del sistema. El sistema apaga los procesos de valores de dwLevel altos a bajos. Las prioridades de apagado más altas y más bajas están reservadas para los componentes del sistema. Este parámetro debe estar en el siguiente intervalo de valores.

Valor	Significado
000-0FF	Intervalo de último apagado reservado por el sistema.
100-1FF	Intervalo de último apagado reservado de la aplicación.
200-2FF	Intervalo de apagado reservado de la aplicación "entre".
300-3FF	Intervalo de primer apagado reservado de la aplicación.
400-4FF	Intervalo de primer apagado reservado por el sistema.

 

Todos los procesos se inician en el nivel de apagado 0x280.

[in] dwFlags

Este parámetro puede ser el siguiente valor.

Valor	Significado
SHUTDOWN_NORETRY 0x00000001	El sistema finaliza el proceso sin mostrar un cuadro de diálogo de reintento para el usuario.

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 aplicaciones que se ejecutan en el contexto de seguridad del sistema no se apagan mediante el sistema operativo. Reciben una notificación de cierre o cierre mediante la función de devolución de llamada instalable a través de SetConsoleCtrlHandler. También reciben una notificación en el orden especificado por el parámetro dwLevel .

Requisitos

Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	processthreadsapi.h (incluye Windows.h en Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll

Vea también

GetProcessShutdownParameters

Funciones de proceso y subproceso

Procesos

SetConsoleCtrlHandler