ShellAboutW-Funktion (shellapi.h)

Zeigt ein Dialogfeld ShellInfo an.

Syntax

INT ShellAboutW(
  [in, optional] HWND    hWnd,
  [in]           LPCWSTR szApp,
  [in, optional] LPCWSTR szOtherStuff,
  [in, optional] HICON   hIcon
);

Parameter

[in, optional] hWnd

Typ: HWND

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

[in] szApp

Typ: LPCTSTR

Ein Zeiger auf eine NULL-endende 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 beschreibbar 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 ist ein #-Trennzeichen vorhanden. In diesem Fall ersetzt der Teil nach dem # die erste Zeile vollständig.

[in, optional] szOtherStuff

Typ: LPCTSTR

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

[in, optional] hIcon

Typ: HICON

Das Handle eines Symbols, das die Funktion im Dialogfeld anzeigt. Dieser Parameter kann NULL sein. In diesem Fall zeigt die Funktion das Windows-Symbol an.

Rückgabewert

Typ: int

TRUE , wenn erfolgreich; andernfalls FALSE.

Hinweise

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

Um ein Beispiel für ein ShellInfo-Dialogfeld anzuzeigen, wählen Sie in Windows Explorer in der Dropdownliste Hilfe die Option Info zu Windows aus.

Hinweis

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

Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shellapi.h
Bibliothek	Shell32.lib
DLL	Shell32.dll (Version 3.51 oder höher)
APIs	ext-ms-win-shell-shell32-l1-2-2 (eingeführt in Windows 10, Version 10.0.14393)