SetProcessShutdownParameters, fonction (processthreadsapi.h)

Article
08/25/2023

Définit les paramètres d’arrêt pour le processus en cours d’appel. Cette fonction définit un ordre d’arrêt pour un processus par rapport aux autres processus du système.

Syntaxe

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

Paramètres

[in] dwLevel

Priorité d’arrêt d’un processus par rapport à d’autres processus dans le système. Le système arrête les processus de valeurs dwLevel élevées à faibles. Les priorités d’arrêt les plus élevées et les plus faibles sont réservées aux composants système. Ce paramètre doit se trouver dans la plage de valeurs suivante.

Valeur	Signification
000-0FF	Plage du dernier arrêt réservé par le système.
100-1FF	Dernière plage d’arrêt réservée à l’application.
200-2FF	Application réservée « entre » plage d’arrêt.
300-3FF	Première plage d’arrêt réservée à l’application.
400-4FF	Première plage d’arrêt réservée au système.

Tous les processus commencent au niveau de l’arrêt 0x280.

[in] dwFlags

Ce paramètre peut être la valeur suivante.

Valeur	Signification
SHUTDOWN_NORETRY 0x00000001	Le système termine le processus sans afficher de boîte de dialogue de nouvelle tentative pour l’utilisateur.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Notes

Les applications exécutées dans le contexte de sécurité du système ne sont pas arrêtées par le système d’exploitation. Ils sont avertis de l’arrêt ou de la fermeture de session via la fonction de rappel installable via SetConsoleCtrlHandler. Ils sont également avertis dans l’ordre spécifié par le paramètre dwLevel .

Spécifications


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	processthreadsapi.h (inclure Windows.h sur Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

GetProcessShutdownParameters

Fonctions de processus et de thread

Processus

SetConsoleCtrlHandler

Partager via