PWLX_DIALOG_BOX_PARAM Rückruffunktion (winwlx.h)

Artikel
03/06/2024

[Die WlxDialogBoxParam-Funktion ist ab Windows Server 2008 und Windows Vista nicht mehr verfügbar.]

Wird von GINA aufgerufen, um Dialogfeldsteuerelemente zu initialisieren und dann ein modales Dialogfeld aus einer Dialogfeldvorlagenressource zu erstellen.

Hinweis GINA-DLLs werden in Windows Vista ignoriert.

Syntax

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

Parameter

[in] hWlx

Gibt das Winlogon-Handle an, das im WlxInitialize-Aufruf an GINA übergeben wird.

[in] hInst

Gibt eine instance des Moduls an, dessen ausführbare Datei die Dialogfeldvorlage enthält.

[in] lpszTemplate

Gibt die Dialogfeldvorlage an. Dieser Parameter ist entweder die Adresse einer NULL-Zeichenfolge, die den Namen der Dialogfeldvorlage angibt, oder ein ganzzahliger Wert, der den Ressourcenbezeichner der Dialogfeldvorlage angibt. Wenn der Parameter einen Ressourcenbezeichner angibt, muss das Wort mit hoher Ordnung null sein, und sein Wort mit niedriger Reihenfolge muss den Bezeichner enthalten. Sie können das MAKEINTRESOURCE-Makro verwenden, um diesen Wert zu erstellen.

[in] hwndOwner

Gibt das Fenster an, das das Dialogfeld besitzt.

[in] dlgprc

Zeigt auf die Dialogfeldprozedur. Weitere Informationen zur Dialogfeldprozedur finden Sie unter DialogProc.

[in] dwInitParam

Gibt den Wert an, der im lParam-Parameter der WM_INITDIALOG Nachricht an das Dialogfeld übergeben werden soll.

Rückgabewert

Wenn die WlxDialogBoxParam-Funktion erfolgreich ist, ist der Rückgabewert der Wert des nResult-Parameters im Aufruf der EndDialog-Funktion angegeben, die zum Beenden des Dialogfelds verwendet wird. In der folgenden Tabelle sind einige mögliche Erfolgsrückgabewerte aufgeführt.

Rückgabecode	Beschreibung
WLX_DLG_INPUT_TIMEOUT	Zeitüberschreitung der Eingabe.
WLX_DLG_SAS	Ein SAS-Ereignis (Secure Attention Sequence ) ist aufgetreten.
WLX_DLG_SCREEN_SAVER_TIMEOUT	Der Bildschirmschoner hat ein Timeout ausgeführt.
WLX_DLG_USER_LOGOFF	Der Benutzer hat sich abgemeldet.

Wenn die Funktion fehlschlägt, ist der Rückgabewert –1.

Hinweise

WlxDialogBoxParam dupliziert die Windows DialogBoxParam-Funktion und ermöglicht winlogon auch das Beenden des Dialogfelds. Weitere Informationen finden Sie unter DialogBoxParam.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winwlx.h