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

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

Lo llama la GINA para crear un cuadro de diálogo modal a partir de una plantilla de cuadro de diálogo.

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

 

Sintaxis

PWLX_DIALOG_BOX PwlxDialogBox;

int PwlxDialogBox(
  [in] HANDLE hWlx,
  [in] HANDLE hInst,
  [in] LPWSTR lpszTemplate,
  [in] HWND hwndOwner,
  [in] DLGPROC dlgprc
)
{...}

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 del 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, vea la función de devolución de llamada DialogProc .

Valor devuelto

Si la función WlxDialogBox se realiza correctamente, el valor devuelto es el parámetro nResult especificado 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

GINA debe usar la función Winlogon WlxDialogBox , no la macro Cuadro de diálogo de Windows. WlxDialogBox duplica la macro Cuadro de diálogo de Windows y también permite a Winlogon finalizar el cuadro de diálogo. Para obtener más información, vea DialogBox.

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

Cuadro de diálogo

DialogProc

EndDialog

MAKEINTRESOURCE

WlxInitialize