RestartDialog-Funktion (shlobj_core.h)

Artikel
08/26/2023

[Diese Funktion ist über Windows XP Service Pack 2 (SP2) und Windows Server 2003 verfügbar. In nachfolgenden Windows-Versionen ist sie möglicherweise geändert oder nicht verfügbar.]

Zeigt ein Dialogfeld an, in dem der Benutzer aufgefordert wird, Windows neu zu starten. Wenn der Benutzer auf die Schaltfläche klickt, ruft die Funktion ExitWindowsEx auf, um zu versuchen, Windows neu zu starten.

Syntax

int RestartDialog(
  [in, optional] HWND   hwnd,
  [in, optional] PCWSTR pszPrompt,
                 DWORD  dwReturn
);

Parameter

[in, optional] hwnd

Typ: HWND

Ein Handle für das übergeordnete Fenster.

[in, optional] pszPrompt

Typ: PCWSTR

Eine Unicode-Zeichenfolge mit Null-Zeichenfolge, die den Text enthält, der im Dialogfeld angezeigt wird, das den Benutzer dazu auffordert.

dwReturn

Art: DWORD

Die Flags, die den Typ des Herunterfahrens angeben.

Dieser Parameter muss einen der folgenden Werte enthalten.

EWX_LOGOFF

Beendet alle Prozesse, die im Sicherheitskontext des Prozesses ausgeführt werden, der diese Funktion aufgerufen hat, und protokolliert den Benutzer dann ab.

EWX_POWEROFF

Fährt das System herunter und schaltet den Strom aus. Das System muss das Power-Off-Feature unterstützen. Der aufrufende Prozess muss über das SE_SHUTDOWN_NAME-Recht verfügen. Weitere Informationen finden Sie unter ExitWindowsEx.

EWX_REBOOT

Fährt das System herunter und startet dann das System neu. Der aufrufende Prozess muss über das SE_SHUTDOWN_NAME-Recht verfügen. Weitere Informationen finden Sie unter ExitWindowsEx.

EWX_SHUTDOWN

Fährt das System bis zu einem Punkt herunter, an dem es sicher ist, den Strom auszuschalten. An diesem Punkt wurden alle Dateipuffer auf den Datenträger geleert, und alle ausgeführten Prozesse wurden beendet. Wenn das System die Funktion zum Ausschalten unterstützt, wird auch die Stromversorgung ausgeschaltet. Der aufrufende Prozess muss über das SE_SHUTDOWN_NAME-Recht verfügen. Weitere Informationen finden Sie unter ExitWindowsEx.

Dieser Parameter kann optional die folgenden Werte enthalten.

EWX_FORCE

Erzwingt das Beenden von Prozessen. Wenn dieses Flag festgelegt ist, sendet das System keine WM_QUERYENDSESSION und WM_ENDSESSION Nachrichten. Dies kann dazu führen, dass die Anwendungen Daten verlieren. Daher sollten Sie dieses Flag nur im Notfall verwenden.

EWX_FORCEIFHUNG

Erzwingt das Beenden von Prozessen, wenn sie nicht auf die WM_QUERYENDSESSION oder WM_ENDSESSION Nachricht reagieren. Dieses Flag wird ignoriert, wenn EWX_FORCE verwendet wird.

Rückgabewert

Typ: int

Gibt den Bezeichner der Schaltfläche zurück, die zum Schließen des Dialogfelds gedrückt wurde.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlobj_core.h (einschließlich Shlobj.h)
Bibliothek	Shell32.lib
DLL	Shell32.dll (Version 5.0 oder höher)
APIs	ext-ms-win-shell-shell32-l1-2-1 (eingeführt in Windows 10, Version 10.0.10240)

Freigeben über