RestartDialog, fonction (shlobj_core.h)

Article
08/26/2023

[Cette fonction est disponible via Windows XP Service Pack 2 (SP2) et Windows Server 2003. Il peut être modifié ou indisponible dans les versions ultérieures de Windows.]

Affiche une boîte de dialogue qui invite l’utilisateur à redémarrer Windows. Lorsque l’utilisateur clique sur le bouton, la fonction appelle ExitWindowsEx pour tenter de redémarrer Windows.

Syntaxe

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

Paramètres

[in, optional] hwnd

Type : HWND

Handle de la fenêtre parente.

[in, optional] pszPrompt

Type : PCWSTR

Chaîne Unicode terminée par null qui contient le texte qui s’affiche dans la boîte de dialogue qui invite l’utilisateur.

dwReturn

Type : DWORD

Indicateurs qui spécifient le type d’arrêt.

Ce paramètre doit inclure l’une des valeurs suivantes.

EWX_LOGOFF

Arrête tous les processus en cours d’exécution dans le contexte de sécurité du processus qui a appelé cette fonction, puis désactive l’utilisateur.

EWX_POWEROFF

Arrête le système et éteint l’alimentation. Le système doit prendre en charge la fonctionnalité de mise hors tension. Le processus appelant doit avoir le privilège SE_SHUTDOWN_NAME . Pour plus d’informations, consultez ExitWindowsEx.

EWX_REBOOT

Arrête le système, puis redémarre le système. Le processus appelant doit avoir le privilège SE_SHUTDOWN_NAME . Pour plus d’informations, consultez ExitWindowsEx.

EWX_SHUTDOWN

Arrête le système à un point où il est sûr de désactiver l’alimentation. À ce stade, toutes les mémoires tampons de fichiers ont été vidées sur le disque et tous les processus en cours d’exécution ont été arrêtés. Si le système prend en charge la fonctionnalité de mise hors tension, l’alimentation est également désactivée. Le processus appelant doit avoir le privilège SE_SHUTDOWN_NAME . Pour plus d’informations, consultez ExitWindowsEx.

Ce paramètre peut éventuellement inclure les valeurs suivantes.

EWX_FORCE

Force les processus à se terminer. Lorsque cet indicateur est défini, le système n’envoie pas les messages WM_QUERYENDSESSION et WM_ENDSESSION . Cela peut entraîner la perte de données des applications. Par conséquent, vous devez utiliser cet indicateur uniquement en cas d’urgence.

EWX_FORCEIFHUNG

Force les processus à se terminer s’ils ne répondent pas au message WM_QUERYENDSESSION ou WM_ENDSESSION . Cet indicateur est ignoré si EWX_FORCE est utilisé.

Valeur retournée

Type : int

Retourne l’identificateur du bouton qui a été enfoncé pour fermer la boîte de dialogue.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h (inclure Shlobj.h)
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 5.0 ou ultérieure)
Ensemble d’API	ext-ms-win-shell-shell32-l1-2-1 (introduit dans Windows 10, version 10.0.10240)

Partager via