ShellAboutA function (shellapi.h)

Displays a ShellAbout dialog box.

Syntax

INT ShellAboutA(
  [in, optional] HWND   hWnd,
  [in]           LPCSTR szApp,
  [in, optional] LPCSTR szOtherStuff,
  [in, optional] HICON  hIcon
);

Parameters

[in, optional] hWnd

Type: HWND

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

[in] 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 writable.

Windows Vista, Windows Server 2008: This string cannot exceed 200 characters in length. The contents of szApp will no longer show after "Microsoft", unless there is a # separator, in which case the part after the # will completely replace the first line.

[in, optional] 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.

[in, optional] 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