ShellMessageBoxA-Funktion (shellapi.h)

Artikel
11/20/2024

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

ShellMessageBox- ist eine spezielle Instanz 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 in pszTitlebenannte Zeichenfolgenressource geladen werden soll. Wenn pszTitle keine Zeichenfolgenressource benen, 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 mit Null beendete Zeichenfolge, die entweder die anzuzeigende Nachricht enthält, oder eine Ressourcen-ID, die angibt, von wo die Nachricht abgerufen werden soll.

[in] lpcTitle

Typ: LPCTSTR-

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Titel des Dialogfelds 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 ladebare Ressource verweist, die mit dem MAKEINTRESOURCE Makro gebildet wird, überschreibt er hWnd als Titel.

[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. Bestimmte Werte finden Sie unter MessageBox-.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Anmerkung

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

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shellapi.h
Library	Shlwapi.lib
DLL-	Shlwapi.dll

Siehe auch

MAKEINTRESOURCE-

MessageBox-

Freigeben über