Функция ShellAboutA (shellapi.h)
Отображает диалоговое окно ShellAbout.
Синтаксис
INT ShellAboutA(
[in, optional] HWND hWnd,
[in] LPCSTR szApp,
[in, optional] LPCSTR szOtherStuff,
[in, optional] HICON hIcon
);
Параметры
[in, optional] hWnd
Тип: HWND
Дескриптор окна родительского окна. Этот параметр может быть NULL.
[in] szApp
Тип: LPCTSTR
Указатель на строку, завершающую значение NULL, содержащую текст, отображаемый в заголовке диалогового окна ShellAbout и в первой строке диалогового окна после текста "Майкрософт". Если текст содержит разделитель (#), разделяющий его на две части, функция отображает первую часть в строке заголовка и вторую часть первой строки после текста "Майкрософт".
Windows 2000, Windows XP, Windows Server 2003: если строка, на которую указывает этот параметр, содержит разделитель (#), строка должна быть записываемой.
Windows Vista, Windows Server 2008: эта строка не может превышать 200 символов в длину. Содержимое szApp больше не будет отображаться после "Майкрософт", если нет разделителя #, в этом случае часть после # полностью заменит первую строку.
[in, optional] szOtherStuff
Тип: LPCTSTR
Указатель на строку, завершающуюся значением NULL, которая содержит текст, отображаемый в диалоговом окне после сведений о версии и авторских правах. Этот параметр может быть NULL.
[in, optional] hIcon
Тип: HICON
Дескриптор значка, отображаемого функцией в диалоговом окне. Этот параметр может быть NULL, в этом случае функция отображает значок Windows.
Возвращаемое значение
Тип: int
TRUE в случае успешного выполнения; в противном случае FALSE.
Замечания
Обратите внимание, что в диалоговом окне функции
Чтобы просмотреть пример диалогового окна ShellAbout, выполните команду winver.exe
.
Заметка
Заголовок shellapi.h определяет ShellAbout как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
Требование | Ценность |
---|---|
минимальные поддерживаемые клиентские | Windows XP [только классические приложения] |
минимальный поддерживаемый сервер | Windows 2000 Server [только классические приложения] |
целевая платформа | Виндоус |
заголовка | shellapi.h |
библиотеки |
Shell32.lib |
DLL | Shell32.dll (версия 3.51 или более поздняя) |
набор API | ext-ms-win-shell-shell32-l1-2-2 (представлено в Windows 10 версии 10.0.14393) |