PWLX_DIALOG_BOX funzione di callback (winwlx.h)

Articolo
08/28/2023

[La funzione WlxDialogBox non è più disponibile per l'uso a partire da Windows Server 2008 e Windows Vista.]

Chiamato dalla GINA per creare una finestra di dialogo modale da un modello di finestra di dialogo.

Nota Le DLL GINA vengono ignorate in Windows Vista.

Sintassi

PWLX_DIALOG_BOX PwlxDialogBox;

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

Parametri

[in] hWlx

Specifica l'handle Winlogon passato a GINA nella chiamata WlxInitialize .

[in] hInst

Specifica un'istanza del modulo il cui file eseguibile contiene il modello della finestra di dialogo.

[in] lpszTemplate

Specifica il modello della finestra di dialogo. Questo parametro è l'indirizzo di una stringa di caratteri con terminazione null che specifica il nome del modello della finestra di dialogo o un valore intero che specifica l'identificatore della risorsa del modello di finestra di dialogo. Se il parametro specifica un identificatore di risorsa, la parola con ordine elevato deve essere zero e la parola a basso ordine deve contenere l'identificatore. È possibile usare la macro MAKEINTRESOURCE per creare questo valore.

[in] hwndOwner

Specifica la finestra proprietaria della finestra di dialogo.

[in] dlgprc

Punta alla procedura della finestra di dialogo. Per altre informazioni sulla procedura della finestra di dialogo, vedere la funzione callback DialogProc .

Valore restituito

Se la funzione WlxDialogBox ha esito positivo, il valore restituito è il parametro nResult specificato nella chiamata alla funzione EndDialog usata per terminare la finestra di dialogo. La tabella seguente elenca alcuni possibili valori restituiti dall'esito positivo.

Codice restituito	Descrizione
WLX_DLG_INPUT_TIMEOUT	Timeout di input.
WLX_DLG_SAS	Si è verificato un evento di sequenza di attenzione sicura (SAS).
WLX_DLG_SCREEN_SAVER_TIMEOUT	Timeout dello screen saver.
WLX_DLG_USER_LOGOFF	L'utente è stato disconnesso.

Se la funzione ha esito negativo, il valore restituito è –1.

Commenti

GINA deve usare la funzione Winlogon WlxDialogBox , non la macro Windows DialogBox . WlxDialogBox duplica la macro Windows DialogBox e consente anche a Winlogon di terminare la finestra di dialogo. Per altre informazioni, vedere DialogBox.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winwlx.h

Vedi anche