AbortSystemShutdownA-Funktion (winreg.h)
Beendet ein ausgelöstes Herunterfahren des Systems.
Syntax
BOOL AbortSystemShutdownA(
[in, optional] LPSTR lpMachineName
);
Parameter
[in, optional] lpMachineName
Der Netzwerkname des Computers, auf dem das Herunterfahren beendet werden soll. Wenn lpMachineNameNULL oder eine leere Zeichenfolge ist, beendet die Funktion das Herunterfahren auf dem lokalen Computer.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Die Funktionen InitiateSystemShutdowndown undInitiateSystemShutdownEx zeigen ein Dialogfeld an, das den Benutzer darüber benachrichtigt, dass das System heruntergefahren wird. Während des Timeouts für das Herunterfahren kann die Funktion AbortSystemShutdown verhindern, dass das System heruntergefahren wird.
Windows Server 2003 und Windows XP mit SP1: Wenn es sich bei dem herunterzufahrenden Computer um einen Terminaldiensteserver handelt, zeigt das System allen lokalen und Remotebenutzern ein Dialogfeld an, das sie darüber warnt, dass das Herunterfahren initiiert wurde. Wenn das Herunterfahren durch AbortSystemShutdown verhindert wird, wird das Systemdialogfeld für die Benutzer angezeigt, in dem sie darüber informiert werden, dass der Server nicht mehr heruntergefahren wird.
Damit der lokale Computer nicht heruntergefahren wird, muss der aufrufende Prozess über das SE_SHUTDOWN_NAME-Recht verfügen. Damit ein Remotecomputer nicht heruntergefahren wird, muss der aufrufende Prozess über das SE_REMOTE_SHUTDOWN_NAME-Recht auf dem Remotecomputer verfügen. Standardmäßig können Benutzer die SE_SHUTDOWN_NAME-Berechtigung auf dem Computer aktivieren, auf dem sie angemeldet sind, und Administratoren können die SE_REMOTE_SHUTDOWN_NAME-Berechtigung auf Remotecomputern aktivieren. Weitere Informationen finden Sie unter Ausführen mit speziellen Berechtigungen.
Häufige Fehlerursachen sind ein ungültiger Computername, ein nicht zugänglicher Computer oder unzureichende Berechtigungen.
Beispiele
Ein Beispiel finden Sie unter Anzeigen des Dialogfelds Herunterfahren.
Hinweis
Der winreg.h-Header definiert AbortSystemShutdown als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winreg.h (einschließlich Windows.h) |
| Bibliothek | Advapi32.lib |
| DLL | Advapi32.dll |