Función EndDialog (winuser.h)

Artículo
03/13/2024

Destruye un cuadro de diálogo modal, lo que hace que el sistema finalice cualquier procesamiento del cuadro de diálogo.

Sintaxis

BOOL EndDialog(
  [in] HWND    hDlg,
  [in] INT_PTR nResult
);

Parámetros

[in] hDlg

Tipo: HWND

Identificador del cuadro de diálogo que se va a destruir.

[in] nResult

Tipo: INT_PTR

Valor que se va a devolver a la aplicación desde la función que creó el cuadro de diálogo.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Los cuadros de diálogo creados por las funciones DialogBox,DialogBoxParam, DialogBoxIndirect y DialogBoxIndirectParam deben destruirse mediante la función EndDialog . Una aplicación llama a EndDialog desde el procedimiento del cuadro de diálogo; la función no se debe usar para ningún otro propósito.

Un procedimiento de cuadro de diálogo puede llamar a EndDialog en cualquier momento, incluso durante el procesamiento del mensaje de WM_INITDIALOG . Si la aplicación llama a la función mientras se está procesando WM_INITDIALOG, el cuadro de diálogo se destruye antes de que se muestre y antes de establecer el foco de entrada.

EndDialog no destruye inmediatamente el cuadro de diálogo. En su lugar, establece una marca y permite que el procedimiento del cuadro de diálogo devuelva el control al sistema. El sistema comprueba la marca antes de intentar recuperar el siguiente mensaje de la cola de aplicaciones. Si se establece la marca, el sistema finaliza el bucle de mensajes, destruye el cuadro de diálogo y usa el valor en nResult como valor devuelto de la función que creó 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	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-dialogbox-l1-1-0 (introducido en Windows 8)