Freigeben über


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.

Hinweis GINA-DLLs werden in Windows Vista ignoriert.
 

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
MB_ABORTRETRYIGNORE
Das Meldungsfeld enthält drei Befehlsschaltflächen: Abbrechen, Wiederholen und Ignorieren.
MB_APPLMODAL
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.

MB_DEFAULT_DESKTOP_ONLY
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.
MB_DEFBUTTON1
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.
MB_DEFBUTTON2
Die zweite Schaltfläche ist eine Standardschaltfläche.
MB_DEFBUTTON3
Die dritte Schaltfläche ist eine Standardschaltfläche.
MB_DEFBUTTON4
Die vierte Schaltfläche ist eine Standardschaltfläche.
MB_ICONASTERISK
Im Meldungsfeld wird ein Symbol angezeigt, das aus einem Kleinbuchstaben in einem Kreis besteht.
MB_ICONEXCLAMATION
Im Meldungsfeld wird ein Ausrufezeichensymbol angezeigt.
MB_ICONHAND
Im Meldungsfeld wird ein Handsymbol angezeigt.
MB_ICONINFORMATION
Im Meldungsfeld wird ein Symbol angezeigt, das aus einem Kleinbuchstaben in einem Kreis besteht.
MB_ICONQUESTION
Im Meldungsfeld wird ein Fragezeichensymbol angezeigt.
MB_ICONSTOP
Im Meldungsfeld wird ein Stoppzeichensymbol angezeigt.
MB_OK
Das Meldungsfeld enthält eine Befehlsschaltfläche: OK.
MB_OKCANCEL
Das Meldungsfeld enthält zwei Befehlsschaltflächen: OK und Abbrechen.
MB_RETRYCANCEL
Das Meldungsfeld enthält zwei Befehlsschaltflächen: Wiederholen und Abbrechen.
MB_SERVICE_NOTIFICATION
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.
MB_SETFOREGROUND
Das Meldungsfeld wird zum Vordergrundfenster. Intern ruft Windows die SetForegroundWindow-Funktion für das Meldungsfeld auf.
MB_SYSTEMMODAL
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.
MB_TASKMODAL
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.
MB_YESNO
Das Meldungsfeld enthält zwei Befehlsschaltflächen: Ja und Nein.
MB_YESNOCANCEL
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.

Hinweis Wenn ein Meldungsfeld über die Schaltfläche Abbrechen verfügt, gibt die Funktion den IDCANCEL-Wert zurück, wenn entweder die ESC-Taste gedrückt oder die Schaltfläche Abbrechen geklickt wird. Wenn das Meldungsfeld keine Schaltfläche Abbrechen aufweist, hat das Drücken von ESC keine Auswirkung.
 
Rückgabecode Beschreibung
IDABORT
Die Schaltfläche Abbrechen wurde ausgewählt.
IDCANCEL
Die Schaltfläche Abbrechen wurde ausgewählt.
IDIGNORE
Die Schaltfläche "Ignorieren " wurde ausgewählt.
IDNO
Eine Schaltfläche wurde nicht ausgewählt.
IDOK
Die Schaltfläche OK wurde ausgewählt.
IDRETRY
Die Schaltfläche "Wiederholen " wurde ausgewählt.
IDYES
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

Weitere Informationen

Messagebox

SetForegroundWindow

WlxDialogBox

WlxDialogBoxIndirect

WlxDialogBoxIndirectParam

WlxInitialize