ShellMessageBoxA-Funktion (shellapi.h)

[ShellMessageBox ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

ShellMessageBox ist eine spezielle instance von MessageBox, die die Möglichkeit bietet, den Titel des Besitzerfensters als Titel des Meldungsfelds zu verwenden.

Syntax

int ShellMessageBoxA(
  [in] HINSTANCE hAppInst,
  [in] HWND      hWnd,
  [in] LPCSTR    lpcText,
  [in] LPCSTR    lpcTitle,
  [in] UINT      fuStyle,
       ...       
);

Parameter

[in] hAppInst

Typ: HINSTANCE

Das Handle des Moduls, aus dem eine Zeichenfolgenressource namens in pszTitle geladen werden soll. Wenn pszTitle keine Zeichenfolgenressource benennet, wird dieser Parameter ignoriert. Dieser Wert muss gültig sein, wenn pszMsg oder pszTitle eine Ressourcen-ID ist.

[in] hWnd

Typ: HWND

Ein Handle für das Besitzerfenster des zu erstellenden Meldungsfelds. Wenn diese Variable nicht NULL ist, wird der Titel des Besitzerfensters als Titel des Meldungsfelds verwendet.

[in] lpcText

Typ: LPCTSTR

Ein Zeiger auf eine NULL-endende Zeichenfolge, die entweder die anzuzeigende Nachricht oder eine Ressourcen-ID enthält, von der angegeben wird, wo die Nachricht abgerufen werden soll.

[in] lpcTitle

Typ: LPCTSTR

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Dialogfeldtitel oder eine Ressourcen-ID enthält, die angibt, wo der Titel abgerufen werden soll. Wenn sowohl dieser Parameter als auch hWndNULL sind, wird kein Titel angezeigt. Wenn dieser Parameter auf eine mit dem MAKEINTRESOURCE-Makro gebildete ladebare Ressource zeigt, wird hWnd als Titel überschrieben.

[in] fuStyle

Typ: UINT

Gibt den Inhalt und das Verhalten des Dialogfelds an. Mögliche Werte finden Sie unter MessageBox.

...

Eine Variablenargumentliste, die mit pszMsg kombiniert wird, um den im Meldungsfeld angezeigten Volltext zu bilden.

Rückgabewert

Typ: int

Ein ganzzahliger Wert, der eine Schaltfläche angibt, die im Meldungsfeld gedrückt wurde. Informationen zu bestimmten Werten finden Sie unter MessageBox.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Hinweis

Der Shellapi.h-Header definiert ShellMessageBox als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shellapi.h
Bibliothek	Shlwapi.lib
DLL	Shlwapi.dll

Weitere Informationen

MAKEINTRESOURCE

Messagebox