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

[La función WlxDialogBoxParam 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 un recurso de plantilla de cuadro de diálogo.

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

 

Sintaxis

PWLX_DIALOG_BOX_PARAM PwlxDialogBoxParam;

int PwlxDialogBoxParam(
  [in] HANDLE hWlx,
  [in] HANDLE hInst,
  [in] LPWSTR lpszTemplate,
  [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 una instancia del módulo cuyo archivo ejecutable contiene la plantilla del cuadro de diálogo.

[in] lpszTemplate

Especifica la plantilla del cuadro de diálogo. Este parámetro es la dirección de una cadena de caracteres terminada en NULL que especifica el nombre de la plantilla de cuadro de diálogo o un valor entero que especifica el identificador de recurso de la plantilla del cuadro de diálogo. Si el parámetro especifica un identificador de recurso, su palabra de orden superior debe ser cero y su palabra de orden inferior debe contener el identificador. Puede usar la macro MAKEINTRESOURCE para crear este valor.

[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 DialogProc.

[in] dwInitParam

Especifica el valor que se va a pasar al cuadro de diálogo en el parámetro lParam del mensaje WM_INITDIALOG .

Valor devuelto

Si la función WlxDialogBoxParam se realiza correctamente, el valor devuelto es el valor del 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.

Comentarios

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

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

Consulte también

DialogBoxParam

DialogProc

EndDialog

MAKEINTRESOURCE

WlxInitialize