PWLX_DIALOG_BOX fonction de rappel (winwlx.h)

Article
03/06/2024

[La fonction WlxDialogBox n’est plus disponible à partir de Windows Server 2008 et Windows Vista.]

Appelé par le GINA pour créer une boîte de dialogue modale à partir d’un modèle de boîte de dialogue.

Note Les DLL GINA sont ignorées dans Windows Vista.

Syntaxe

PWLX_DIALOG_BOX PwlxDialogBox;

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

Paramètres

[in] hWlx

Spécifie le handle Winlogon passé à GINA dans l’appel WlxInitialize .

[in] hInst

Spécifie une instance du module dont le fichier exécutable contient le modèle de boîte de dialogue.

[in] lpszTemplate

Spécifie le modèle de boîte de dialogue. Ce paramètre est soit l’adresse d’une chaîne de caractères terminée par null qui spécifie le nom du modèle de boîte de dialogue, soit une valeur entière qui spécifie l’identificateur de ressource du modèle de boîte de dialogue. Si le paramètre spécifie un identificateur de ressource, son mot d’ordre élevé doit être égal à zéro et son mot d’ordre inférieur doit contenir l’identificateur. Vous pouvez utiliser la macro MAKEINTRESOURCE pour créer cette valeur.

[in] hwndOwner

Spécifie la fenêtre qui possède la boîte de dialogue.

[in] dlgprc

Pointe vers la procédure de boîte de dialogue. Pour plus d’informations sur la procédure de boîte de dialogue, consultez la fonction de rappel DialogProc .

Valeur retournée

Si la fonction WlxDialogBox réussit, la valeur de retour est le paramètre nResult donné dans l’appel à la fonction EndDialog utilisée pour mettre fin à la boîte de dialogue. Le tableau suivant répertorie quelques valeurs de retour de réussite possibles.

Code de retour	Description
WLX_DLG_INPUT_TIMEOUT	Le délai d’entrée a expiré.
WLX_DLG_SAS	Un événement de séquence d’attention sécurisée (SAS) s’est produit.
WLX_DLG_SCREEN_SAVER_TIMEOUT	L’économiseur d’écran a expiré.
WLX_DLG_USER_LOGOFF	L’utilisateur s’est déconnecté.

Si la fonction échoue, la valeur de retour est –1.

Remarques

GINA doit utiliser la fonction Winlogon WlxDialogBox , et non la macro Windows DialogBox . WlxDialogBox duplique la macro DialogBox Windows et permet également à Winlogon d’arrêter la boîte de dialogue. Pour plus d’informations, consultez DialogBox.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winwlx.h