PWLX_DIALOG_BOX_INDIRECT Rückruffunktion (winwlx.h)

Artikel
08/28/2023

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

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

Hinweis GINA-DLLs werden in Windows Vista ignoriert.

Syntax

PWLX_DIALOG_BOX_INDIRECT PwlxDialogBoxIndirect;

int PwlxDialogBoxIndirect(
  [in] HANDLE hWlx,
  [in] HANDLE hInst,
  [in] LPCDLGTEMPLATE hDialogTemplate,
  [in] HWND hwndOwner,
  [in] DLGPROC dlgprc
)
{...}

Parameter

[in] hWlx

Winlogon-Handle, das GINA im WlxInitialize-Aufruf bereitgestellt wird.

[in] hInst

Gibt die instance des Moduls an, das das Dialogfeld erstellt.

[in] hDialogTemplate

Gibt die Adresse eines globalen Speicherobjekts an, das eine Dialogfeldvorlage enthält, die zum Erstellen des Dialogfelds verwendet wird. Die Vorlage ist in Form einer DLGTEMPLATE-Struktur gefolgt von mindestens einer DLGITEMTEMPLATE-Struktur . Eine vollständige Beschreibung dieser Strukturen finden Sie im Platform SDK.

[in] hwndOwner

Gibt das Fenster an, das das Dialogfeld besitzt.

[in] dlgprc

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

Rückgabewert

Wenn die WlxDialogBoxIndirect-Funktion erfolgreich ist, ist der Rückgabewert der nResult-Parameter , der im Aufruf der EndDialog-Funktion zum Beenden des Dialogfelds angegeben 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

WlxDialogBoxIndirect dupliziert das Windows DialogBoxIndirect-Makro und ermöglicht winlogon auch das Beenden des Dialogfelds. Weitere Informationen finden Sie unter DialogBoxIndirect.

Anforderungen


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