Funzione RestartDialog (shlobj_core.h)

[Questa funzione è disponibile tramite Windows XP Service Pack 2 (SP2) e Windows Server 2003. Potrebbe essere modificato o non disponibile nelle versioni successive di Windows.]

Visualizza una finestra di dialogo che richiede all'utente di riavviare Windows. Quando l'utente fa clic sul pulsante, la funzione chiama ExitWindowsEx per tentare di riavviare Windows.

Sintassi

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

Parametri

[in, optional] hwnd

Tipo: HWND

Handle alla finestra padre.

[in, optional] pszPrompt

Tipo: PCWSTR

Stringa Unicode con terminazione null contenente il testo visualizzato nella finestra di dialogo che richiede all'utente.

dwReturn

Tipo: DWORD

Flag che specificano il tipo di arresto.

Questo parametro deve includere uno dei valori seguenti.

EWX_LOGOFF

Arresta tutti i processi in esecuzione nel contesto di sicurezza del processo che ha chiamato questa funzione, quindi registra l'utente disattivato.

EWX_POWEROFF

Arresta il sistema e disattiva la potenza. Il sistema deve supportare la funzionalità di disattivazione. Il processo di chiamata deve avere il privilegio di SE_SHUTDOWN_NAME . Per altre informazioni, vedere ExitWindowsEx.

EWX_REBOOT

Arresta il sistema e quindi riavvia il sistema. Il processo di chiamata deve avere il privilegio di SE_SHUTDOWN_NAME . Per altre informazioni, vedere ExitWindowsEx.

EWX_SHUTDOWN

Arresta il sistema a un punto in cui è sicuro disattivare la potenza. A questo punto, tutti i buffer di file sono stati scaricati su disco e tutti i processi in esecuzione sono stati arrestati. Se il sistema supporta la funzionalità di disattivazione, l'alimentazione viene disattivata. Il processo di chiamata deve avere il privilegio di SE_SHUTDOWN_NAME . Per altre informazioni, vedere ExitWindowsEx.

Questo parametro può facoltativamente includere i valori seguenti.

EWX_FORCE

Forza l'interruzione dei processi. Quando questo flag è impostato, il sistema non invia i messaggi di WM_QUERYENDSESSION e WM_ENDSESSION . Ciò può causare la perdita di dati delle applicazioni. Pertanto, è consigliabile usare questo flag solo in un'emergenza.

EWX_FORCEIFHUNG

Impone ai processi di terminare se non rispondono al messaggio di WM_QUERYENDSESSION o WM_ENDSESSION . Questo flag viene ignorato se viene usato EWX_FORCE .

Valore restituito

Tipo: int

Restituisce l'identificatore del pulsante premuto per chiudere la finestra di dialogo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlobj_core.h (include Shlobj.h)
Libreria	Shell32.lib
DLL	Shell32.dll (versione 5.0 o successiva)
Set di API	ext-ms-win-shell-shell32-l1-2-1 (introdotta in Windows 10, versione 10.0.10240)