Button_SetElevationRequiredState macro (commctrl.h)

Sets the elevation required state for a specified button or command link to display an elevated icon. Use this macro or send the BCM_SETSHIELD message explicitly.

Syntax

void Button_SetElevationRequiredState(
  [in]  hwnd,
  [in]  fRequired
);

Parameters

[in] hwnd

Type: HWND

A handle to the button control.

[in] fRequired

Type: BOOL

TRUE to draw an elevated icon, or FALSE otherwise.

Return value

None

Remarks

An application must 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]
Target Platform Windows
Header commctrl.h