Compartir a través de


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