Función MessageBoxIndirectA (winuser.h)

Artículo
08/27/2023

Crea, muestra y opera un cuadro de mensaje. El cuadro de mensaje contiene texto y título del mensaje definido por la aplicación, cualquier icono y cualquier combinación de botones de inserción predefinidos.

Sintaxis

int MessageBoxIndirectA(
  [in] const MSGBOXPARAMSA *lpmbp
);

Parámetros

[in] lpmbp

Tipo: const LPMSGBOXPARAMS

Puntero a una estructura MSGBOXPARAMS que contiene información utilizada para mostrar el cuadro de mensaje.

Valor devuelto

Tipo: int

Si la función se ejecuta correctamente, el valor devuelto es uno de los siguientes valores de elemento de menú.

Si un cuadro de mensaje tiene un botón Cancelar , la función devuelve el valor IDCANCEL si se presiona la tecla ESC o se selecciona el botón Cancelar . Si el cuadro de mensaje no tiene ningún botón Cancelar , presionar ESC no tiene ningún efecto.

Si no hay suficiente memoria para crear el cuadro de mensaje, el valor devuelto es cero.

Código o valor devuelto	Descripción
IDABORT 3	Se ha seleccionado el botón Anular .
IDCANCEL 2	Se ha seleccionado el botón Cancelar .
IDCONTINUE 11	Se ha seleccionado el botón Continuar .
IDIGNORE 5	Se ha seleccionado el botón Omitir .
IDNO 7	Se ha seleccionado el botón No .
IDOK 1	Se ha seleccionado el botón Aceptar .
IDRETRY 4	Se ha seleccionado el botón Reintentar .
IDTRYAGAIN 10	Se ha seleccionado el botón Probar de nuevo .
IDYES 6	Se ha seleccionado el botón Sí .

Comentarios

Cuando se usa un cuadro de mensaje modal del sistema para indicar que el sistema tiene poca memoria, las cadenas a las que apuntan los miembros lpszText y lpszCaption de la estructura MSGBOXPARAMS no deben tomarse de un archivo de recursos, ya que se puede producir un error al intentar cargar el recurso.

Si crea un cuadro de mensaje mientras un cuadro de diálogo está presente, use un identificador para el cuadro de diálogo como parámetro hWnd . El parámetro hWnd no debe identificar una ventana secundaria, como un control en un cuadro de diálogo.

Nota

El encabezado winuser.h define MessageBoxIndirect como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

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	winuser.h (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-dialogbox-l1-1-0 (introducido en Windows 8)