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] 對話框標題欄中的文字，以及文字 “Microsoft” 後面的對話框第一行。如果文字包含分隔符（#）將它分割成兩個部分，函式會在標題欄中顯示第一個部分，並在文字 “Microsoft” 之後的第一行顯示第一個部分。

Windows 2000、Windows XP、Windows Server 2003：如果此參數所指向的字元串包含分隔符（#），則必須寫入字符串。

Windows Vista、Windows Server 2008：此字串長度不能超過 200 個字元。 szApp 的內容將不會再顯示在 “Microsoft”之後，除非有 #分隔符，在此情況下，# 後面的部分會完全取代第一行。

[in, optional] szOtherStuff

類型：LPCTSTR

Null 終止字串的指標，其中包含版本和著作權信息之後對話框中要顯示的文字。此參數可以是 NULL。

[in, optional] hIcon

類型：HICON

函式顯示在對話框中的圖示句柄。此參數可以 NULL，在此情況下，函式會顯示 Windows 圖示。

類型：int

如果成功，TRUE;否則，FALSE。

請注意，ShellAbout 函式對話方塊會使用 Windows 特有的文字和預設圖示。

若要查看 [殼層][關於] 對話框的範例，請從 Windows 檔案總管的 [說明] 功能表下拉功能表中選擇 [關於 Windows] 。

注意

shellapi.h 標頭會將ShellAbout定義為別名，根據UNICODE預處理器常數的定義，自動選取此函式的ANSI或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求	價值
最低支援的用戶端	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 中引進）