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

Artículo
03/08/2023

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

Llamado por GINA para inicializar controles de cuadro de diálogo y, a continuación, 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_PARAM PwlxDialogBoxIndirectParam;

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

Parámetros

[in] hWlx

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

[in] hInst

Especifica 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

Especifica 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 la descripción de la función de devolución de llamada DialogProc en el SDK de plataforma.

[in] dwInitParam

Especifica el valor utilizado para inicializar el control de cuadro de diálogo. Este valor se pasa al cuadro de diálogo en el parámetro lParam del mensaje de WM_INITDIALOG .

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve el parámetro nResult especificado en la llamada a la función EndDialog usada 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

WlxDialogBoxIndirectParam duplica la función DialogBoxIndirectParam de Windows y también permite que Winlogon finalice el cuadro de diálogo. Para obtener más información, vea DialogBoxIndirectParam.

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