AbortSystemShutdownW-Funktion (winreg.h)
Stoppt das Herunterfahren des Systems, das initiiert wurde.
Syntax
BOOL AbortSystemShutdownW(
[in, optional] LPWSTR 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 fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Die funktionen InitiateSystemShutdown und InitiateSystemShutdownEx zeigen ein Dialogfeld an, in dem der Benutzer benachrichtigt wird, dass das System heruntergefahren wird. Während des Timeoutzeitraums kann das AbortSystemShutdown Funktion verhindern, dass das System heruntergefahren wird.
Windows Server 2003 und Windows XP mit SP1: Wenn der Computer heruntergefahren werden soll, zeigt das System ein Dialogfeld für alle lokalen und Remotebenutzer an, dass das Herunterfahren initiiert wurde. Wenn das Herunterfahren durch AbortSystemShutdownverhindert wird, wird dem Benutzer das Dialogfeld angezeigt, das sie darüber informiert, dass der Server nicht mehr heruntergefahren wird.
Um zu verhindern, dass der lokale Computer heruntergefahren wird, muss der aufrufende Prozess über die SE_SHUTDOWN_NAME Berechtigung verfügen. Um zu verhindern, dass ein Remotecomputer heruntergefahren wird, muss der aufrufende Prozess über die SE_REMOTE_SHUTDOWN_NAME Berechtigungen auf dem Remotecomputer verfügen. Standardmäßig können Benutzer die SE_SHUTDOWN_NAME Berechtigungen auf dem Computer aktivieren, auf dem sie angemeldet sind, und Administratoren können die SE_REMOTE_SHUTDOWN_NAME Berechtigungen auf Remotecomputern aktivieren. Weitere Informationen finden Sie unter Ausführen mit speziellen Rechten.
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".
Anmerkung
Der winreg.h-Header definiert AbortSystemShutdown als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, 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 |
|---|---|
| mindestens unterstützte Client- | Windows XP [Desktop-Apps | UWP-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
| Zielplattform- | Fenster |
| Header- | winreg.h (enthalten Windows.h) |
| Library | Advapi32.lib |
| DLL- | Advapi32.dll |