RestartDialogEx, fonction (shlobj_core.h)

[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 demande à l’utilisateur de redémarrer Windows. Lorsque l’utilisateur clique sur le bouton, la fonction appelle ExitWindowsEx pour tenter de redémarrer Windows.

Syntaxe

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

Paramètres

[in, optional] hwnd

Type : HWND

Handle de la fenêtre parente.

[in, optional] pszPrompt

Type : PCWSTR

Chaîne terminée par un caractère Null qui contient le texte qui s’affiche dans la boîte de dialogue pour inviter 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. Ensuite, l’utilisateur est désactivé.

EWX_POWEROFF

Arrête le système et 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 couper 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 l’arrêt des processus. 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 ne devez utiliser cet indicateur qu’en cas d’urgence.

EWX_FORCEIFHUNG

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

dwReasonCode

Type : DWORD

Windows XP :Spécifie la raison du lancement de l’arrêt. Pour plus d’informations, consultez Codes de raison de l’arrêt du système.

Windows 2000 : Ce paramètre est ignoré.

Valeur retournée

Type : int

Retourne l’identificateur du bouton sur lequel vous avez appuyé pour fermer la boîte de dialogue.

Configuration requise