PWLX_MESSAGE_BOX fonction de rappel (winwlx.h)

Article
08/28/2023

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

La fonction WlxMessageBox est appelée par GINA pour créer, afficher et utiliser une boîte de message.

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

Syntaxe

PWLX_MESSAGE_BOX PwlxMessageBox;

int PwlxMessageBox(
  [in] HANDLE hWlx,
  [in] HWND hwndOwner,
  [in] LPWSTR lpszText,
  [in] LPWSTR lpszTitle,
  [in] UINT fuStyle
)
{...}

Paramètres

[in] hWlx

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

[in] hwndOwner

Spécifie la fenêtre propriétaire de la zone de message à créer. Si ce paramètre a la valeur NULL, la zone de message n’a pas de fenêtre propriétaire.

[in] lpszText

Pointe vers une chaîne terminée par null qui contient le message à afficher.

[in] lpszTitle

Pointe vers une chaîne terminée par null utilisée pour le titre de la boîte de dialogue. Si ce paramètre a la valeur NULL, le titre par défaut Error est utilisé.

[in] fuStyle

Spécifie le contenu et le comportement de la boîte de dialogue. Ce paramètre peut être une combinaison des valeurs suivantes.

Valeur	Signification
MB_ABORTRETRYIGNORE	La boîte de message contient trois boutons de commande : Abandonner, Réessayer et Ignorer.
MB_APPLMODAL	L’utilisateur doit répondre à la boîte de message avant de continuer à travailler dans la fenêtre identifiée par le paramètre hWndOwner . Toutefois, l’utilisateur peut se déplacer vers les fenêtres d’autres applications pour travailler. En fonction de la hiérarchie des fenêtres dans l’application, l’utilisateur peut être en mesure de passer à d’autres fenêtres au sein de l’application. Toutes les fenêtres enfants du parent de la boîte de message sont automatiquement désactivées, mais pas les fenêtres contextuelles. MB_APPLMODAL est la valeur par défaut si ni MB_SYSTEMMODAL ni MB_TASKMODAL n’est spécifié.
MB_DEFAULT_DESKTOP_ONLY	Le bureau qui reçoit actuellement l’entrée doit être un bureau par défaut ; sinon, la fonction échoue. Un bureau par défaut est un bureau sur lequel une application s’exécute une fois que l’utilisateur s’est connecté.
MB_DEFBUTTON1	Le premier bouton est le bouton par défaut. Notez que le premier bouton est toujours la valeur par défaut, sauf si MB_DEFBUTTON2 ou MB_DEFBUTTON3 est spécifié.
MB_DEFBUTTON2	Le deuxième bouton est un bouton par défaut.
MB_DEFBUTTON3	Le troisième bouton est un bouton par défaut.
MB_DEFBUTTON4	Le quatrième bouton est un bouton par défaut.
MB_ICONASTERISK	Une icône composée d’une lettre minuscule dans un cercle apparaît dans la boîte de message.
MB_ICONEXCLAMATION	Une icône de point d’exclamation s’affiche dans la boîte de message.
MB_ICONHAND	Une icône de main s’affiche dans la boîte de message.
MB_ICONINFORMATION	Une icône composée d’une lettre minuscule dans un cercle apparaît dans la boîte de message.
MB_ICONQUESTION	Une icône de point d’interrogation s’affiche dans la boîte de message.
MB_ICONSTOP	Une icône de signe d’arrêt s’affiche dans la boîte de message.
MB_OK	La boîte de message contient un bouton de commande : OK.
MB_OKCANCEL	La boîte de message contient deux boutons de commande : OK et Annuler.
MB_RETRYCANCEL	La boîte de message contient deux boutons de commande : Réessayer et Annuler.
MB_SERVICE_NOTIFICATION	L’appelant est un service qui avertit l’utilisateur d’un événement. La fonction affiche une boîte de message sur le bureau actif actuel, même s’il n’y a aucun utilisateur connecté à l’ordinateur.
MB_SETFOREGROUND	La boîte de message devient la fenêtre de premier plan. En interne, Windows appelle la fonction SetForegroundWindow pour la boîte de message.
MB_SYSTEMMODAL	Toutes les applications sont suspendues jusqu’à ce que l’utilisateur réponde à la boîte de message. Sauf si l’application spécifie MB_ICONHAND, la boîte de message ne devient modale qu’après sa création. Par conséquent, la fenêtre propriétaire et d’autres fenêtres continuent de recevoir des messages résultant de son activation. Utilisez des boîtes de message modales système pour avertir l’utilisateur des erreurs graves et potentiellement dangereuses qui nécessitent une attention immédiate, par exemple, un manque de mémoire.
MB_TASKMODAL	Identique à MB_APPLMODAL sauf que toutes les fenêtres de niveau supérieur qui appartiennent à la tâche actuelle sont désactivées si le paramètre hWndOwner a la valeur NULL. Utilisez cet indicateur lorsque l’application ou la bibliothèque appelante n’a pas de handle de fenêtre disponible, mais doit toujours empêcher l’entrée dans d’autres fenêtres de l’application actuelle sans interrompre d’autres applications.
MB_YESNO	La boîte de message contient deux boutons de commande : Oui et Non.
MB_YESNOCANCEL	La boîte de message contient trois boutons de commande : Oui, Non et Annuler.

Valeur retournée

Si la fonction échoue ou s’il n’y a pas suffisamment de mémoire pour créer la boîte de message, la valeur de retour est zéro.

Si la fonction réussit, la valeur de retour est l’une des valeurs d’élément de menu suivantes retournées par la boîte de dialogue.

Note Si une boîte de message a un bouton Annuler , la fonction retourne la valeur IDCANCEL si vous appuyez sur la touche Échap ou si vous cliquez sur le bouton Annuler . Si la boîte de message n’a pas de bouton Annuler , l’appui sur Échap n’a aucun effet.

Code de retour	Description
IDABORT	Le bouton Abandonner a été sélectionné.
IDCANCEL	Le bouton Annuler a été sélectionné.
IDIGNORE	Le bouton Ignorer a été sélectionné.
IDNO	Aucun bouton n’a été sélectionné.
IDOK	Le bouton OK a été sélectionné.
IDRETRY	Le bouton Nouvelle tentative a été sélectionné.
IDYES	Le bouton Oui a été sélectionné.

Remarques

La fonction WlxMessageBox ne gère pas les événements SAS et ne convient pas aux boîtes de dialogue de sécurité. Utilisez la fonction WlxDialogBox, WlxDialogBoxIndirect ou WlxDialogBoxIndirectParam pour les boîtes de dialogue de sécurité.

WlxMessageBox duplique la fonction Windows MessageBox , à l’exception du fait que cette fonction permet également à Winlogon d’expirer la boîte de dialogue. Pour plus d’informations, consultez MessageBox.

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