PWLX_DIALOG_BOX_PARAM fonction de rappel (winwlx.h)

Article
03/04/2024

[La fonction WlxDialogBoxParam n’est plus disponible depuis Windows Server 2008 et Windows Vista.]

Appelé par GINA pour initialiser les contrôles de boîte de dialogue, puis créer une boîte de dialogue modale à partir d’une ressource de modèle de boîte de dialogue.

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

Syntaxe

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

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 DialogProc.

[in] dwInitParam

Spécifie la valeur à passer à la boîte de dialogue dans le paramètre lParam du message WM_INITDIALOG .

Valeur retournée

Si la fonction WlxDialogBoxParam réussit, la valeur de retour est la valeur du paramètre nResult donné dans l’appel à la fonction EndDialog utilisée pour arrêter 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

WlxDialogBoxParam duplique la fonction Windows DialogBoxParam et permet également à Winlogon d’arrêter la boîte de dialogue. Pour plus d’informations, consultez DialogBoxParam.

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

Voir aussi