PWLX_DIALOG_BOX Rückruffunktion (winwlx.h)

Artikel
03/04/2024

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

Wird von der GINA aufgerufen, um ein modales Dialogfeld aus einer Dialogfeldvorlage zu erstellen.

Hinweis GINA-DLLs werden in Windows Vista ignoriert.

Syntax

PWLX_DIALOG_BOX PwlxDialogBox;

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

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 das Wort mit niedriger Ordnung 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

Verweist auf die Dialogfeldprozedur. Weitere Informationen zur Dialogfeldprozedur finden Sie in der Rückruffunktion DialogProc .

Rückgabewert

Wenn die WlxDialogBox-Funktion erfolgreich ist, ist der Rückgabewert der nResult-Parameter , der im Aufruf der EndDialog-Funktion angegeben wird, 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	Timeout der Eingabe.
WLX_DLG_SAS	Ein SAS-Ereignis (Secure Attention Sequence ) ist aufgetreten.
WLX_DLG_SCREEN_SAVER_TIMEOUT	Timeout für den Bildschirmschoner.
WLX_DLG_USER_LOGOFF	Der Benutzer hat sich abgemeldet.

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

Hinweise

GINA muss die Winlogon-Funktion WlxDialogBox und nicht das Windows DialogBox-Makro verwenden. WlxDialogBox dupliziert das Windows DialogBox-Makro und ermöglicht winlogon auch das Beenden des Dialogfelds. Weitere Informationen finden Sie unter DialogBox.

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