Función RestartDialog (shlobj_core.h)

Artículo
03/02/2024

[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 solicita 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 RestartDialog(
  [in, optional] HWND   hwnd,
  [in, optional] PCWSTR pszPrompt,
                 DWORD  dwReturn
);

Parámetros

[in, optional] hwnd

Tipo: HWND

Identificador de la ventana primaria.

[in, optional] pszPrompt

Tipo: PCWSTR

Cadena Unicode terminada en null que contiene el texto que se muestra en el cuadro de diálogo que solicita 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 y, a continuación, cierra el 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 .

Valor devuelto

Tipo: int

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

Requisitos

Requisito	Value
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)
Conjunto de API	ext-ms-win-shell-shell32-l1-2-1 (introducido en Windows 10, versión 10.0.10240)

Compartir a través de