Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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
LRESULT Button_SetElevationRequiredState(
[in] HWND hwnd,
[in] BOOL 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
Type: LRESULT
Returns 1 if successful, or an error code otherwise.
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 |