SetProcessShutdownParameters, fonction (processthreadsapi.h)

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