Función RestartDialogEx (shlobj_core.h)

Artículo
08/26/2023

[Esta función está disponible a través de Windows XP Service Pack 2 (SP2) y Windows Server 2003. Puede modificarse o no estar disponible en versiones posteriores de Windows.

Muestra un cuadro de diálogo que pide al usuario que reinicie Windows. Cuando el usuario hace clic en el botón, la función llama a ExitWindowsEx para intentar reiniciar Windows.

Sintaxis

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

Parámetros

[in, optional] hwnd

Tipo: HWND

Identificador de la ventana primaria.

[in, optional] pszPrompt

Tipo: PCWSTR

Cadena terminada en NULL que contiene el texto que se muestra en el cuadro de diálogo para solicitar al usuario.

dwReturn

Tipo: DWORD

Marcas que especifican el tipo de apagado.

Este parámetro debe incluir uno de los valores siguientes.

EWX_LOGOFF

Cierra todos los procesos que se ejecutan en el contexto de seguridad del proceso que llamó a esta función. A continuación, cierra la sesión del usuario.

EWX_POWEROFF

Apaga el sistema y apaga la alimentación. El sistema debe admitir la característica de apagado. El proceso de llamada debe tener el privilegio SE_SHUTDOWN_NAME . Para obtener más información, vea ExitWindowsEx.

EWX_REBOOT

Apaga el sistema y, a continuación, reinicia el sistema. El proceso de llamada debe tener el privilegio SE_SHUTDOWN_NAME. Para obtener más información, vea ExitWindowsEx.

EWX_SHUTDOWN

Apaga el sistema a un punto en el que es seguro apagar la alimentación. En este momento, todos los búferes de archivos se han vaciado en el disco y todos los procesos en ejecución se han detenido. Si el sistema admite la característica de apagado, la alimentación también se apaga. El proceso de llamada debe tener el privilegio SE_SHUTDOWN_NAME. Para obtener más información, vea ExitWindowsEx.

Este parámetro puede incluir opcionalmente los valores siguientes.

EWX_FORCE

Fuerza a los procesos a terminar. Cuando se establece esta marca, el sistema no envía el WM_QUERYENDSESSION y WM_ENDSESSION mensajes. Esto puede hacer que las aplicaciones pierdan datos. Por lo tanto, solo debe usar esta marca en una emergencia.

EWX_FORCEIFHUNG

Fuerza a los procesos a finalizar si no responden al mensaje WM_QUERYENDSESSION o WM_ENDSESSION . Esta marca se omite si se usa EWX_FORCE.

dwReasonCode

Tipo: DWORD

Windows XP:Especifica el motivo para iniciar el apagado. Para obtener más información, vea Códigos de motivo del apagado del sistema.

Windows 2000: Este parámetro se omite.

Valor devuelto

Tipo: int

Devuelve el identificador del botón que se presionó para cerrar el cuadro de diálogo.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlobj_core.h (incluya Shlobj.h)
Library	Shell32.lib
Archivo DLL	Shell32.dll (versión 5.0 o posterior)

Compartir a través de