PWLX_DIALOG_BOX_INDIRECT_PARAM Rückruffunktion (winwlx.h)

Artikel
08/28/2023

[Die WlxDialogBoxIndirectParam-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 Dialogfeldvorlage im Arbeitsspeicher zu erstellen.

Hinweis GINA-DLLs werden in Windows Vista ignoriert.

Syntax

PWLX_DIALOG_BOX_INDIRECT_PARAM PwlxDialogBoxIndirectParam;

int PwlxDialogBoxIndirectParam(
  [in] HANDLE hWlx,
  [in] HANDLE hInst,
  [in] LPCDLGTEMPLATE hDialogTemplate,
  [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 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 in der Beschreibung der DialogProc-Rückruffunktion im Platform SDK.

[in] dwInitParam

Gibt den Wert an, der zum Initialisieren des Dialogfeldsteuerelements verwendet wird. Dieser Wert wird an das Dialogfeld im lParam-Parameter der WM_INITDIALOG Nachricht übergeben.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion den nResult-Parameter zurück, der im Aufruf der EndDialog-Funktion angegeben ist, 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

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

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