ShellAboutA-Funktion (shellapi.h)

Artikel
11/20/2024

Zeigt ein dialogfeld ShellAbout an.

Syntax

INT ShellAboutA(
  [in, optional] HWND   hWnd,
  [in]           LPCSTR szApp,
  [in, optional] LPCSTR szOtherStuff,
  [in, optional] HICON  hIcon
);

Parameter

[in, optional] hWnd

Typ: HWND-

Ein Fensterziehpunkt für ein übergeordnetes Fenster. Dieser Parameter kann NULL-sein.

[in] szApp

Typ: LPCTSTR-

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die Text enthält, der in der Titelleiste des Dialogfelds ShellAbout und in der ersten Zeile des Dialogfelds nach dem Text "Microsoft" angezeigt werden soll. Wenn der Text ein Trennzeichen (#) enthält, das ihn in zwei Teile unterteilt, zeigt die Funktion den ersten Teil in der Titelleiste und den zweiten Teil in der ersten Zeile nach dem Text "Microsoft" an.

Windows 2000, Windows XP, Windows Server 2003: Wenn die Zeichenfolge, auf die dieser Parameter verweist, ein Trennzeichen (#) enthält, muss die Zeichenfolge schreibbar sein.

Windows Vista, Windows Server 2008: Diese Zeichenfolge darf maximal 200 Zeichen lang sein. Der Inhalt von szApp wird nach "Microsoft" nicht mehr angezeigt, es sei denn, es gibt ein #-Trennzeichen, in diesem Fall ersetzt der Teil nach der #die erste Zeile vollständig.

[in, optional] szOtherStuff

Typ: LPCTSTR-

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die Text enthält, der nach der Version und den Copyrightinformationen im Dialogfeld angezeigt werden soll. Dieser Parameter kann NULL-sein.

[in, optional] hIcon

Typ: HICON-

Das Handle eines Symbols, das von der Funktion im Dialogfeld angezeigt wird. Dieser Parameter kann NULL-sein, in diesem Fall zeigt die Funktion das Windows-Symbol an.

Rückgabewert

Typ: int

TRUE bei erfolgreicher Ausführung; andernfalls FALSE.

Bemerkungen

Beachten Sie, dass das Dialogfeld ShellAbout-Funktion Text und ein Standardsymbol verwendet, das für Windows spezifisch ist.

Wenn Sie ein Beispiel für ein dialogfeld ShellAbout anzeigen möchten, wählen Sie in der Dropdownliste Hilfe windows-Explorer Info zu Windows aus.

Anmerkung

Der shellapi.h-Header definiert ShellAbout 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 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shellapi.h
Library	Shell32.lib
DLL-	Shell32.dll (Version 3.51 oder höher)
API-Satz	ext-ms-win-shell-shell32-l1-2-2 (eingeführt in Windows 10, Version 10.0.14393)

Freigeben über