PWLX_MESSAGE_BOX función de devolución de llamada (winwlx.h)

Artículo
03/04/2024

[La función WlxMessageBox ya no está disponible para su uso a partir de Windows Server 2008 y Windows Vista.]

GINA llama a la función WlxMessageBox para crear, mostrar y operar un cuadro de mensaje.

Nota Los archivos DLL de GINA se omiten en Windows Vista.

Sintaxis

PWLX_MESSAGE_BOX PwlxMessageBox;

int PwlxMessageBox(
  [in] HANDLE hWlx,
  [in] HWND hwndOwner,
  [in] LPWSTR lpszText,
  [in] LPWSTR lpszTitle,
  [in] UINT fuStyle
)
{...}

Parámetros

[in] hWlx

Especifica el identificador de Winlogon pasado a GINA en la llamada a WlxInitialize .

[in] hwndOwner

Especifica la ventana de propietario del cuadro de mensaje que se va a crear. Si este parámetro es NULL, el cuadro de mensaje no tiene ninguna ventana de propietario.

[in] lpszText

Apunta a una cadena terminada en NULL que contiene el mensaje que se va a mostrar.

[in] lpszTitle

Apunta a una cadena terminada en null usada para el título del cuadro de diálogo. Si este parámetro es NULL, se usa el título predeterminado Error.

[in] fuStyle

Especifica el contenido y el comportamiento del cuadro de diálogo. Este parámetro puede ser una combinación de los valores siguientes.

Value	Significado
MB_ABORTRETRYIGNORE	El cuadro de mensaje contiene tres botones de comando: Anular, Reintentar e Omitir.
MB_APPLMODAL	El usuario debe responder al cuadro de mensaje antes de continuar trabajando en la ventana identificada por el parámetro hWndOwner . Sin embargo, el usuario puede pasar a ventanas de otras aplicaciones para que funcionen. Según la jerarquía de ventanas de la aplicación, es posible que el usuario pueda moverse a otras ventanas dentro de la aplicación. Todas las ventanas secundarias del elemento primario del cuadro de mensaje se deshabilitan automáticamente, pero las ventanas emergentes no. MB_APPLMODAL es el valor predeterminado si no se especifican ni MB_SYSTEMMODAL ni MB_TASKMODAL.
MB_DEFAULT_DESKTOP_ONLY	El escritorio que recibe actualmente la entrada debe ser un escritorio predeterminado; de lo contrario, se produce un error en la función. Un escritorio predeterminado es uno en el que se ejecuta una aplicación después de que el usuario haya iniciado sesión.
MB_DEFBUTTON1	El primer botón es el predeterminado. Tenga en cuenta que el primer botón siempre es el valor predeterminado a menos que se especifique MB_DEFBUTTON2 o MB_DEFBUTTON3.
MB_DEFBUTTON2	El segundo botón es un botón predeterminado.
MB_DEFBUTTON3	El tercer botón es un botón predeterminado.
MB_DEFBUTTON4	El cuarto botón es un botón predeterminado.
MB_ICONASTERISK	Un icono que consta de una letra minúscula en un círculo aparece en el cuadro de mensaje.
MB_ICONEXCLAMATION	Aparece un icono de signo de exclamación en el cuadro de mensaje.
MB_ICONHAND	Aparece un icono de mano en el cuadro de mensaje.
MB_ICONINFORMATION	Un icono que consta de una letra minúscula en un círculo aparece en el cuadro de mensaje.
MB_ICONQUESTION	Aparece un icono de signo de interrogación en el cuadro de mensaje.
MB_ICONSTOP	Aparece un icono de signo de detención en el cuadro de mensaje.
MB_OK	El cuadro de mensaje contiene un botón de comando: Aceptar.
MB_OKCANCEL	El cuadro de mensaje contiene dos botones de comando: Aceptar y Cancelar.
MB_RETRYCANCEL	El cuadro de mensaje contiene dos botones de comando: Reintentar y Cancelar.
MB_SERVICE_NOTIFICATION	El autor de llamada es un servicio que notifica al usuario sobre un evento. La función abre un cuadro de mensaje en el escritorio activo actual, incluso si no hay ningún usuario que haya iniciado sesión en el equipo.
MB_SETFOREGROUND	El cuadro de mensaje se convierte en la ventana de primer plano. Internamente, Windows llama a la función SetForegroundWindow para el cuadro de mensaje.
MB_SYSTEMMODAL	Se suspenden todas las aplicaciones hasta que el usuario responda al cuadro de mensaje. A menos que la aplicación especifique MB_ICONHAND, el cuadro de mensaje no se convierte en modal hasta después de crearse. Por lo tanto, la ventana del propietario y otras ventanas siguen recibiendo mensajes resultantes de su activación. Use cuadros de mensaje modales del sistema para notificar al usuario si hay errores graves y potencialmente perjudiciales que requieren atención inmediata, por ejemplo, sin memoria.
MB_TASKMODAL	Igual que MB_APPLMODAL excepto que todas las ventanas de nivel superior que pertenecen a la tarea actual están deshabilitadas si el parámetro hWndOwner es NULL. Use esta marca cuando la aplicación o biblioteca que realiza la llamada no tenga disponible un identificador de ventana, pero debe evitar la entrada a otras ventanas de la aplicación actual sin suspender otras aplicaciones.
MB_YESNO	El cuadro de mensaje contiene dos botones de comando: Sí y No.
MB_YESNOCANCEL	El cuadro de mensaje contiene tres botones de comando: Sí, No y Cancelar.

Valor devuelto

Si se produce un error en la función o si no hay suficiente memoria para crear el cuadro de mensaje, el valor devuelto es cero.

Si la función se ejecuta correctamente, el valor devuelto es uno de los siguientes valores de elemento de menú devueltos por el cuadro de diálogo.

Nota 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 hace clic en el botón Cancelar . Si el cuadro de mensaje no tiene ningún botón Cancelar , presionar ESC no tiene ningún efecto.

Código devuelto	Descripción
IDABORT	Se ha seleccionado el botón Anular.
IDCANCEL	Se ha seleccionado el botón Cancelar.
IDIGNORE	Se ha seleccionado omitir el botón.
IDNO	No se ha seleccionado un botón.
IDOK	Se ha seleccionado el botón Aceptar.
IDRETRY	Se ha seleccionado el botón Reintentar.
IDYES	Se ha seleccionado el botón Sí.

Comentarios

La función WlxMessageBox no controla los eventos de SAS y no es adecuado para los cuadros de diálogo de seguridad. Use la función WlxDialogBox, WlxDialogBoxIndirect o WlxDialogBoxIndirectParam para los cuadros de diálogo de seguridad.

WlxMessageBox duplica la función Cuadro de mensajes de Windows, con la excepción de que esta función también permite a Winlogon agotar el tiempo de espera del cuadro de diálogo. Para obtener más información, vea MessageBox.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winwlx.h