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.

Syntax

To send this message, call the SendMessage function as follows.

lResult = SendMessage(    // returns LRESULT in lResult
   hWndControl,           // (HWND) handle to destination control
   BCM_SETSHIELD,         // (UINT) message ID
   wParam,                // = 0; not used, must be zero 
   lParam                 // = (LPARAM)(BOOL) fRequired;
);

Parameters

wParam

Must be zero.

fRequired

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

Message Information

Header	Declared in Commctrl.h
Minimum operating systems	Windows Vista