AbortSystemShutdownA, fonction (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 est NULL ou une chaîne vide, la fonction arrête l’arrêt sur l’ordinateur local.
Valeur de retour
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’erreur étendues, appelez GetLastError.
Remarques
Les fonctions InitiateSystemShutdown et InitiateSystemShutdownEx affichent une boîte de dialogue qui informe l’utilisateur que le système s’arrête. Pendant la période d’expiration du délai d’arrêt, la fonction AbortSystemShutdown peut empêcher l’arrêt du système.
Windows Server 2003 et Windows XP avec SP1 : Si l’ordinateur à arrêter est un serveur Terminal Services, le système affiche une boîte de dialogue à tous les utilisateurs locaux et distants leur indiquant que l’arrêt a été lancé. Si l’arrêt est empêché par AbortSystemShutdown, le système affiche la boîte de dialogue aux utilisateurs qui les informent 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 disposer du 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 un privilège insuffisant.
Exemples
Pour obtenir un exemple, consultez Affichage de la boîte de dialogue Arrêt.
Note
L’en-tête winreg.h définit AbortSystemShutdown comme 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP [applications de bureau | Applications UWP] |
| serveur minimum pris en charge | Windows Server 2003 [applications de bureau | Applications UWP] |
| plateforme cible | Windows |
| d’en-tête | winreg.h (inclure Windows.h) |
| bibliothèque | Advapi32.lib |
| DLL | Advapi32.dll |