ShellAboutA function

Displays a ShellAbout dialog box.

Syntax

INT ShellAboutA(
  HWND   hWnd,
  LPCSTR szApp,
  LPCSTR szOtherStuff,
  HICON  hIcon
);

Parameters

hWnd

Type: HWND

A window handle to a parent window. This parameter can be NULL.

szApp

Type: LPCTSTR

A pointer to a null-terminated string that contains text to be displayed in the title bar of the ShellAbout dialog box and on the first line of the dialog box after the text "Microsoft". If the text contains a separator (#) that divides it into two parts, the function displays the first part in the title bar and the second part on the first line after the text "Microsoft".

Windows 2000, Windows XP, Windows Server 2003: If the string pointed to by this parameter contains a separator (#), then the string must be writeable.

Windows Vista, Windows Server 2008: This string cannot exceed 200 characters in length.

szOtherStuff

Type: LPCTSTR

A pointer to a null-terminated string that contains text to be displayed in the dialog box after the version and copyright information. This parameter can be NULL.

hIcon

Type: HICON

The handle of an icon that the function displays in the dialog box. This parameter can be NULL, in which case the function displays the Windows icon.

Return Value

Type: int

TRUE if successful; otherwise, FALSE.

Remarks

Note that the ShellAbout function dialog box uses text and a default icon that are specific to Windows.

To see an example of a ShellAbout dialog box, choose About Windows from the Help menu drop-down list in Windows Explorer.

Requirements

   
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header shellapi.h
Library Shell32.lib
DLL Shell32.dll (version 3.51 or later)