Fonction AbortSystemShutdownA (winreg.h)

Arrête un arrêt du système qui a été lancé.

Syntaxe

BOOL AbortSystemShutdownA(
  [in, optional] LPSTR lpMachineName
);

Paramètres

[in, optional] lpMachineName

Nom réseau de l’ordinateur sur lequel l’arrêt doit être arrêté. Si lpMachineName a la valeur NULL ou une chaîne vide, la fonction arrête l’arrêt sur l’ordinateur local.

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.

Remarques

Les fonctions InitiateSystemShutdown et InitiateSystemShutdownEx affichent une boîte de dialogue qui avertit l’utilisateur que le système s’arrête. Pendant la période de délai d’arrêt, la fonction AbortSystemShutdown peut empêcher le système de s’arrêter.

Windows Server 2003 et Windows XP avec SP1 : Si l’ordinateur à arrêter est un serveur des services Terminal Server, le système affiche une boîte de dialogue à tous les utilisateurs locaux et distants qui les avertit que l’arrêt a été lancé. Si l’arrêt est empêché par AbortSystemShutdown, la boîte de dialogue s’affiche aux utilisateurs pour les informer que le serveur n’est plus arrêté.

Pour empêcher l’arrêt de l’ordinateur local, le processus appelant doit disposer du privilège SE_SHUTDOWN_NAME. Pour empêcher l’arrêt d’un ordinateur distant, le processus appelant doit avoir le privilège SE_REMOTE_SHUTDOWN_NAME sur l’ordinateur distant. Par défaut, les utilisateurs peuvent activer le privilège SE_SHUTDOWN_NAME sur l’ordinateur sur lequel ils sont connectés, et les administrateurs peuvent activer le privilège SE_REMOTE_SHUTDOWN_NAME sur les ordinateurs distants. Pour plus d’informations, consultez Exécution avec des privilèges spéciaux.

Les raisons courantes de l’échec incluent un nom d’ordinateur non valide, un ordinateur inaccessible ou des privilèges insuffisants.

Exemples

Pour obtenir un exemple, consultez Affichage de la boîte de dialogue Arrêter.

Notes

L’en-tête winreg.h définit AbortSystemShutdown comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible	Windows
En-tête	winreg.h (inclure Windows.h)
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll

Voir aussi

InitiateSystemShutdown

Fermeture

Fonctions d’arrêt du système