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

Artículo
08/28/2023

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

Llamado por GINA para crear un cuadro de diálogo modal a partir de una plantilla de cuadro de diálogo en memoria.

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

Sintaxis

PWLX_DIALOG_BOX_INDIRECT PwlxDialogBoxIndirect;

int PwlxDialogBoxIndirect(
  [in] HANDLE hWlx,
  [in] HANDLE hInst,
  [in] LPCDLGTEMPLATE hDialogTemplate,
  [in] HWND hwndOwner,
  [in] DLGPROC dlgprc
)
{...}

Parámetros

[in] hWlx

Identificador de Winlogon proporcionado a GINA en la llamada a WlxInitialize .

[in] hInst

Identifica la instancia del módulo que crea el cuadro de diálogo.

[in] hDialogTemplate

Especifica la dirección de un objeto de memoria global que contiene una plantilla de cuadro de diálogo utilizada para crear el cuadro de diálogo. La plantilla tiene la forma de una estructura DLGTEMPLATE seguida de una o varias estructuras DLGITEMTEMPLATE . Para obtener una descripción completa de estas estructuras, consulte El SDK de plataforma.

[in] hwndOwner

Identifica la ventana propietaria del cuadro de diálogo.

[in] dlgprc

Apunta al procedimiento del cuadro de diálogo. Para obtener más información sobre el procedimiento del cuadro de diálogo, consulte DialogProc.

Valor devuelto

Si la función WlxDialogBoxIndirect se realiza correctamente, el valor devuelto es el parámetro nResult proporcionado en la llamada a la función EndDialog utilizada para finalizar el cuadro de diálogo. En la tabla siguiente se enumeran algunos valores devueltos correctos posibles.

Código devuelto	Descripción
WLX_DLG_INPUT_TIMEOUT	Se agota el tiempo de espera de entrada.
WLX_DLG_SAS	Se produjo un evento de secuencia de atención segura (SAS).
WLX_DLG_SCREEN_SAVER_TIMEOUT	Se agota el tiempo de espera del protector de pantalla.
WLX_DLG_USER_LOGOFF	El usuario ha cerrado la sesión.

Si se produce un error en la función, el valor devuelto es –1.

Observaciones

WlxDialogBoxIndirect duplica la macro DialogBoxIndirect de Windows y también permite a Winlogon finalizar el cuadro de diálogo. Para obtener más información, vea DialogBoxIndirect.

Requisitos


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