Partager via


PWLX_MESSAGE_BOX fonction de rappel (winwlx.h)

[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

Voir aussi

MessageBox

SetForegroundWindow

WlxDialogBox

WlxDialogBoxIndirect

WlxDialogBoxIndirectParam

WlxInitialize