Click here to Skip to main content
14,838,821 members
Articles / Programming Languages / C#
Posted 22 Apr 2007


76 bookmarked

Add a UAC shield to a button when elevation is required for admin tasks

Rate me:
Please Sign up or sign in to vote.
4.55/5 (35 votes)
22 Apr 20072 min read
Add a UAC shield to a button when elevation is required for admin tasks using the API, and elevate the process if required.
Screenshot - VistaSecurity.png


Any application that does not always need administrator privileges should not run with them by default. However, when a user wants to perform a task that requires elevation, you need to show them that this is required by displaying the Vista shield icon. When this is clicked, your application will then need to restart with administrator privileges. Interested? Then read on...

Making the VistaSecurity Class

First we need to create a VistaSecurity class. Inside it we need the SendMessage API.

public static extern UInt32 SendMessage
    (IntPtr hWnd, UInt32 msg, UInt32 wParam, UInt32 lParam);

internal const int BCM_FIRST = 0x1600; //Normal button
internal const int BCM_SETSHIELD = (BCM_FIRST + 0x000C); //Elevated button

First, before we add a shield, we need to know if the process is elevated or not which is easily done. To add a shield to a button, make sure that the button uses FlatStyle.System and then sends the appropriate message using the API. The important API function parameters are the handle of the button and the BCM_SETSHIELD message.

static internal bool IsAdmin()
    WindowsIdentity id = WindowsIdentity.GetCurrent();
    WindowsPrincipal p = new WindowsPrincipal(id);
    return p.IsInRole(WindowsBuiltInRole.Administrator);

static internal void AddShieldToButton(Button b)
    b.FlatStyle = FlatStyle.System;
    SendMessage(b.Handle, BCM_SETSHIELD, 0, 0xFFFFFFFF);

We then need a way to elevate the process if required. We just restart the process with the "runas" Verb. The current unelevated process is then exited unless the System.ComponentModel.Win32Exception is thrown, as this indicates that the user has clicked Cancel on the UAC prompt.

internal static void RestartElevated()
    ProcessStartInfo startInfo = new ProcessStartInfo();
    startInfo.UseShellExecute = true;
    startInfo.WorkingDirectory = Environment.CurrentDirectory;
    startInfo.FileName = Application.ExecutablePath;
    startInfo.Verb = "runas";
        Process p = Process.Start(startInfo);
    catch(System.ComponentModel.Win32Exception ex)


That's it for the VistaSecurity class.

Using the code

On the form, you need the following code in your constructor after InitializeComponent which will add the shield.

if (!VistaSecurity.IsAdmin())
    this.Text += " (Standard)"; //Unnecessary
    VistaSecurity.AddShieldToButton(buttonGetElevation); //Important
    this.Text += " (Elevated)";

When the button is clicked we need to check if you have permission to perform the required action or elevate.

if (VistaSecurity.IsAdmin())

Well, that's how to display a shield and get elevation!

Points of Interest

For the admin task in this demo, I added a file VISTA.TXT to All Users' start menu at \ProgramData\Microsoft\Windows\Start Menu\. To get rid of the file, run the demo again (admin credentials may be required!). The Try Admin Task button just tries to create the file without asking for elevation.


  • 22 Apr 07 - Article written
  • 24 Apr 07 - Checking of Administrator account works for non-English versions of Windows by using WindowsBuiltInRole.Administrator instead of a non-localized string. In DoAdminTask(), MessageBoxes show what has been done, more error catching added, and an Environment.SpecialFolder is used to get the path.


This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


About the Author

Software Developer (Senior)
United Kingdom United Kingdom
No Biography provided

Comments and Discussions

GeneralPerfect Pin
almamy67-Apr-20 8:30
Memberalmamy67-Apr-20 8:30 
GeneralMy vote of 5 Pin
almamy67-Apr-20 8:09
Memberalmamy67-Apr-20 8:09 
QuestionCant get the UAC icon to a button Pin
hanonymouss1-Mar-12 4:11
Memberhanonymouss1-Mar-12 4:11 
QuestionLicense for this Component Pin
streetsjingo30-Nov-11 10:45
Memberstreetsjingo30-Nov-11 10:45 
QuestionAwesome! + How wrong can you be? Pin
Vercas3-Oct-10 4:10
MemberVercas3-Oct-10 4:10 
GeneralCode Pin
Brandon Holland12-Jul-09 3:21
MemberBrandon Holland12-Jul-09 3:21 
GeneralRestart application Pin
jammmie99924-May-09 22:55
professionaljammmie99924-May-09 22:55 
GeneralRe: Restart application Pin
McoreD30-Aug-09 15:34
MemberMcoreD30-Aug-09 15:34 
AnswerRe: Restart application Pin
Indivara28-Jan-10 14:14
professionalIndivara28-Jan-10 14:14 
Questionhow to remove it ? Pin
vishal108221-May-09 16:46
Membervishal108221-May-09 16:46 
AnswerRe: how to remove it ? Pin
jammmie99924-May-09 22:54
professionaljammmie99924-May-09 22:54 
AnswerRe: how to remove it ? Pin
Sky Sanders27-Dec-09 7:23
MemberSky Sanders27-Dec-09 7:23 
GeneralIsAdmin Function - an easier way Pin
dmex7-Jan-09 7:51
Memberdmex7-Jan-09 7:51 
GeneralRe: IsAdmin Function - an easier way Pin
vtchris7-Jan-10 8:11
Membervtchris7-Jan-10 8:11 Pin
Jorge Rocha29-Dec-08 15:05
MemberJorge Rocha29-Dec-08 15:05 
GeneralRe: Pin
JumpyCODE13-Mar-09 20:55
MemberJumpyCODE13-Mar-09 20:55 
GeneralRe: Pin
zerosoft_uk26-Jul-11 12:14
Memberzerosoft_uk26-Jul-11 12:14 
GeneralExcellant... and i rolled it all into a handy control :D Pin
FocusedWolf25-May-08 19:32
MemberFocusedWolf25-May-08 19:32 
GeneralRe: Excellant... and i rolled it all into a handy control :D Pin
FocusedWolf25-May-08 19:35
MemberFocusedWolf25-May-08 19:35 
GeneralRe: Excellant... and i rolled it all into a handy control :D Pin
FocusedWolf26-May-08 10:11
MemberFocusedWolf26-May-08 10:11 
GeneralRe: Excellant... and i rolled it all into a handy control :D Pin
FocusedWolf30-May-08 9:40
MemberFocusedWolf30-May-08 9:40 
GeneralRe: Excellant... and i rolled it all into a handy control :D Pin
f r i s c h19-Aug-08 1:54
Memberf r i s c h19-Aug-08 1:54 
RantRe: Excellant... and i rolled it all into a handy control :D Pin
98z2825-Feb-10 8:48
Member98z2825-Feb-10 8:48 
GeneralWont detect properly except for first user in Vista Pin
leifre11-Apr-08 8:08
Memberleifre11-Apr-08 8:08 
Question.NET 3? Pin
JimShabadoo2-Nov-07 8:34
MemberJimShabadoo2-Nov-07 8:34 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.