RestartDialogEx-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 Versionen von Windows 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 RestartDialogEx(
  [in, optional] HWND   hwnd,
  [in, optional] PCWSTR pszPrompt,
                 DWORD  dwReturn,
                 DWORD  dwReasonCode
);

Parameter

[in, optional] hwnd

Typ: HWND

Ein Handle für das übergeordnete Fenster.

[in, optional] pszPrompt

Typ: PCWSTR

Eine Zeichenfolge mit NULL-Beendigung, die den Text enthält, der im Dialogfeld angezeigt wird, um den Benutzer aufzufordern.

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. Anschließend wird der Benutzer abgelogen.

EWX_POWEROFF

Schaltet das System herunter und schaltet den Strom aus. Das System muss die Abschaltfunktion unterstützen. Der aufrufende Prozess muss über die berechtigung SE_SHUTDOWN_NAME 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 die berechtigung SE_SHUTDOWN_NAME verfügen. Weitere Informationen finden Sie unter ExitWindowsEx.

EWX_SHUTDOWN

Schaltet 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 Ausschaltfunktion unterstützt, wird auch der Strom ausgeschaltet. Der aufrufende Prozess muss über die berechtigung SE_SHUTDOWN_NAME 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 die WM_QUERYENDSESSION und WM_ENDSESSION Nachrichten nicht. 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.

dwReasonCode

Art: DWORD

Windows XP:Gibt den Grund für das Initiieren des Herunterfahrens an. Weitere Informationen finden Sie unter Ursachencodes für das Herunterfahren des Systems.

Windows 2000: Dieser Parameter wird ignoriert.

Rückgabewert

Typ: int

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

Anforderungen


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 (shlobj.h einschließen)
Bibliothek	Shell32.lib
DLL	Shell32.dll (Version 5.0 oder höher)

Share via