PWLX_MESSAGE_BOX función de devolución de llamada (winwlx.h)
[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.
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 |
|---|---|
|
El cuadro de mensaje contiene tres botones de comando: Anular, Reintentar e Omitir. |
|
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. |
|
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. |
|
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. |
|
El segundo botón es un botón predeterminado. |
|
El tercer botón es un botón predeterminado. |
|
El cuarto botón es un botón predeterminado. |
|
Un icono que consta de una letra minúscula en un círculo aparece en el cuadro de mensaje. |
|
Aparece un icono de signo de exclamación en el cuadro de mensaje. |
|
Aparece un icono de mano en el cuadro de mensaje. |
|
Un icono que consta de una letra minúscula en un círculo aparece en el cuadro de mensaje. |
|
Aparece un icono de signo de interrogación en el cuadro de mensaje. |
|
Aparece un icono de signo de detención en el cuadro de mensaje. |
|
El cuadro de mensaje contiene un botón de comando: Aceptar. |
|
El cuadro de mensaje contiene dos botones de comando: Aceptar y Cancelar. |
|
El cuadro de mensaje contiene dos botones de comando: Reintentar y Cancelar. |
|
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. |
|
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. |
|
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. |
|
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. |
|
El cuadro de mensaje contiene dos botones de comando: Sí y No. |
|
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.
| Código devuelto | Descripción |
|---|---|
|
Se ha seleccionado el botón Anular. |
|
Se ha seleccionado el botón Cancelar. |
|
Se ha seleccionado omitir el botón. |
|
No se ha seleccionado un botón. |
|
Se ha seleccionado el botón Aceptar. |
|
Se ha seleccionado el botón Reintentar. |
|
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 |