PWLX_DIALOG_BOX_PARAM funzione di callback (winwlx.h)

Articolo
03/13/2024

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

Chiamata da GINA per inizializzare i controlli della finestra di dialogo e quindi creare una finestra di dialogo modale da una risorsa modello di finestra di dialogo.

Nota Le DLL GINA vengono ignorate in Windows Vista.

Sintassi

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
)
{...}

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

[in] dwInitParam

Specifica il valore da passare alla finestra di dialogo nel parametro lParam del messaggio WM_INITDIALOG .

Valore restituito

Se la funzione WlxDialogBoxParam ha esito positivo, il valore restituito è il valore del parametro nResult specificato nella chiamata alla funzione EndDialog utilizzata 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

WlxDialogBoxParam duplica la funzione Windows DialogBoxParam e consente anche a Winlogon di terminare la finestra di dialogo. Per altre informazioni, vedere DialogBoxParam.

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