PWLX_MESSAGE_BOX Rückruffunktion (winwlx.h)
[Die WlxMessageBox-Funktion ist ab Windows Server 2008 und Windows Vista nicht mehr verfügbar.]
Die WlxMessageBox-Funktion wird von GINA aufgerufen, um ein Meldungsfeld zu erstellen, anzuzeigen und zu betreiben.
Syntax
PWLX_MESSAGE_BOX PwlxMessageBox;
int PwlxMessageBox(
[in] HANDLE hWlx,
[in] HWND hwndOwner,
[in] LPWSTR lpszText,
[in] LPWSTR lpszTitle,
[in] UINT fuStyle
)
{...}
Parameter
[in] hWlx
Gibt das Winlogon-Handle an, das im WlxInitialize-Aufruf an GINA übergeben wird.
[in] hwndOwner
Gibt das Besitzerfenster des zu erstellenden Meldungsfelds an. Wenn dieser Parameter NULL ist, hat das Meldungsfeld kein Besitzerfenster.
[in] lpszText
Zeigt auf eine NULL-Zeichenfolge, die die anzuzeigende Nachricht enthält.
[in] lpszTitle
Zeigt auf eine NULL-Zeichenfolge, die für den Dialogfeldtitel verwendet wird. Wenn dieser Parameter NULL ist, wird der Standardtitel Error verwendet.
[in] fuStyle
Gibt den Inhalt und das Verhalten des Dialogfelds an. Für diesen Parameter ist eine Kombination der folgenden Werte gültig.
| Wert | Bedeutung |
|---|---|
|
Das Meldungsfeld enthält drei Befehlsschaltflächen: Abbrechen, Wiederholen und Ignorieren. |
|
Der Benutzer muss auf das Meldungsfeld reagieren, bevor er in dem durch den hWndOwner-Parameter identifizierten Fenster weiterarbeiten kann. Der Benutzer kann jedoch zu Fenstern anderer Anwendungen wechseln, um zu funktionieren.
Abhängig von der Hierarchie der Fenster in der Anwendung kann der Benutzer möglicherweise zu anderen Fenstern innerhalb der Anwendung wechseln. Alle untergeordneten Fenster des übergeordneten Meldungsfelds werden automatisch deaktiviert, Popupfenster jedoch nicht. MB_APPLMODAL ist der Standardwert, wenn weder MB_SYSTEMMODAL noch MB_TASKMODAL angegeben ist. |
|
Der Desktop, der derzeit Eingaben empfängt, muss ein Standarddesktop sein. andernfalls schlägt die Funktion fehl. Ein Standarddesktop ist ein Desktop, auf dem eine Anwendung ausgeführt wird, nachdem sich der Benutzer angemeldet hat. |
|
Die erste Schaltfläche ist die Standardschaltfläche. Beachten Sie, dass die erste Schaltfläche immer die Standardeinstellung ist, es sei denn, es wird MB_DEFBUTTON2 oder MB_DEFBUTTON3 angegeben. |
|
Die zweite Schaltfläche ist eine Standardschaltfläche. |
|
Die dritte Schaltfläche ist eine Standardschaltfläche. |
|
Die vierte Schaltfläche ist eine Standardschaltfläche. |
|
Im Meldungsfeld wird ein Symbol angezeigt, das aus einem Kleinbuchstaben in einem Kreis besteht. |
|
Im Meldungsfeld wird ein Ausrufezeichensymbol angezeigt. |
|
Im Meldungsfeld wird ein Handsymbol angezeigt. |
|
Im Meldungsfeld wird ein Symbol angezeigt, das aus einem Kleinbuchstaben in einem Kreis besteht. |
|
Im Meldungsfeld wird ein Fragezeichensymbol angezeigt. |
|
Im Meldungsfeld wird ein Stoppzeichensymbol angezeigt. |
|
Das Meldungsfeld enthält eine Befehlsschaltfläche: OK. |
|
Das Meldungsfeld enthält zwei Befehlsschaltflächen: OK und Abbrechen. |
|
Das Meldungsfeld enthält zwei Befehlsschaltflächen: Wiederholen und Abbrechen. |
|
Der Aufrufer ist ein Dienst, der den Benutzer über ein Ereignis benachrichtigt. Die Funktion öffnet ein Meldungsfeld auf dem aktuell aktiven Desktop, auch wenn kein Benutzer am Computer angemeldet ist. |
|
Das Meldungsfeld wird zum Vordergrundfenster. Intern ruft Windows die SetForegroundWindow-Funktion für das Meldungsfeld auf. |
|
Alle Anwendungen werden angehalten, bis der Benutzer auf das Meldungsfeld antwortet. Es sei denn, die Anwendung gibt MB_ICONHAND an, wird das Meldungsfeld erst nach der Erstellung modal. Folglich erhalten das Besitzerfenster und andere Fenster weiterhin Nachrichten, die sich aus seiner Aktivierung ergeben. Verwenden Sie systemmodale Meldungsfelder, um den Benutzer über schwerwiegende, potenziell schädliche Fehler zu benachrichtigen, die sofortige Aufmerksamkeit erfordern, z. B. wenn der Arbeitsspeicher knapp wird. |
|
Identisch mit MB_APPLMODAL außer, dass alle Fenster der obersten Ebene, die zur aktuellen Aufgabe gehören, deaktiviert sind, wenn der hWndOwner-ParameterNULL ist. Verwenden Sie dieses Flag, wenn für die aufrufende Anwendung oder Bibliothek kein Fensterhandle verfügbar ist, aber dennoch eingaben für andere Fenster in der aktuellen Anwendung verhindert werden muss, ohne andere Anwendungen anzuhalten. |
|
Das Meldungsfeld enthält zwei Befehlsschaltflächen: Ja und Nein. |
|
Das Meldungsfeld enthält drei Befehlsschaltflächen: Ja, Nein und Abbrechen. |
Rückgabewert
Wenn die Funktion fehlschlägt oder nicht genügend Arbeitsspeicher zum Erstellen des Meldungsfelds vorhanden ist, ist der Rückgabewert 0.
Wenn die Funktion erfolgreich ist, ist der Rückgabewert einer der folgenden Menüelementwerte, die vom Dialogfeld zurückgegeben werden.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Schaltfläche Abbrechen wurde ausgewählt. |
|
Die Schaltfläche Abbrechen wurde ausgewählt. |
|
Die Schaltfläche "Ignorieren " wurde ausgewählt. |
|
Eine Schaltfläche wurde nicht ausgewählt. |
|
Die Schaltfläche OK wurde ausgewählt. |
|
Die Schaltfläche "Wiederholen " wurde ausgewählt. |
|
Die Schaltfläche "Ja " wurde ausgewählt. |
Hinweise
Die WlxMessageBox-Funktion verarbeitet keine SAS-Ereignisse und eignet sich nicht für Sicherheitsdialogfelder. Verwenden Sie die Funktionen WlxDialogBox, WlxDialogBoxIndirect oder WlxDialogBoxIndirectParam für Sicherheitsdialogfelder.
WlxMessageBox dupliziert die Windows MessageBox-Funktion , mit der Ausnahme, dass winlogon auch ein Timeout des Dialogfelds zulässt. Weitere Informationen finden Sie unter MessageBox.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winwlx.h |