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.
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 |
|---|---|
|
La boîte de message contient trois boutons de commande : Abandonner, Réessayer et Ignorer. |
|
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é. |
|
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é. |
|
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é. |
|
Le deuxième bouton est un bouton par défaut. |
|
Le troisième bouton est un bouton par défaut. |
|
Le quatrième bouton est un bouton par défaut. |
|
Une icône composée d’une lettre minuscule dans un cercle apparaît dans la boîte de message. |
|
Une icône de point d’exclamation s’affiche dans la boîte de message. |
|
Une icône de main s’affiche dans la boîte de message. |
|
Une icône composée d’une lettre minuscule dans un cercle apparaît dans la boîte de message. |
|
Une icône de point d’interrogation s’affiche dans la boîte de message. |
|
Une icône de signe d’arrêt s’affiche dans la boîte de message. |
|
La boîte de message contient un bouton de commande : OK. |
|
La boîte de message contient deux boutons de commande : OK et Annuler. |
|
La boîte de message contient deux boutons de commande : Réessayer et Annuler. |
|
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. |
|
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. |
|
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. |
|
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. |
|
La boîte de message contient deux boutons de commande : Oui et Non. |
|
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.
| Code de retour | Description |
|---|---|
|
Le bouton Abandonner a été sélectionné. |
|
Le bouton Annuler a été sélectionné. |
|
Le bouton Ignorer a été sélectionné. |
|
Aucun bouton n’a été sélectionné. |
|
Le bouton OK a été sélectionné. |
|
Le bouton Nouvelle tentative a été sélectionné. |
|
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 |