ShellAboutA-Funktion (shellapi.h)
Zeigt ein Dialogfeld ShellInfo 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 Fensterhandle zu einem übergeordneten Fenster. Dieser Parameter kann NULL sein.
[in] szApp
Typ: LPCTSTR
Ein Zeiger auf eine 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 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-Zeichenfolge, die Text enthält, der im Dialogfeld nach den Versions- und Urheberrechtsinformationen angezeigt werden soll. Dieser Parameter kann NULL sein.
[in, optional] hIcon
Typ: HICON
Der 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 , 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 Hilfemenü 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 nicht codierungsneutralem Code 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) |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für