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

Weitere Informationen

InitialSystemShutdown

Herunterfahren

Funktionen zum Herunterfahren des Systems