BCM_SETSHIELD message

Sets the elevation required state for a specified button or command link to display an elevated icon. Send this message explicitly or by using the Button_SetElevationRequiredState macro.

Parameters

wParam

Must be zero.

lParam [in]

A BOOL that is TRUE to draw an elevated icon, or FALSE otherwise.

Return value

Returns 1 if successful, or an error code otherwise.

Remarks

An application must be manifested to use comctl32.dll version 6 to gain this functionality.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2008 [desktop apps only]
Header
Commctrl.h