/MANIFESTUAC (Embeds UAC information in manifest)

  • Article

Specifies whether User Account Control (UAC) information is embedded in the program manifest.

/MANIFESTUAC
/MANIFESTUAC:NO
/MANIFESTUAC:fragment
/MANIFESTUAC:level=_level
/MANIFESTUAC:uiAccess=_uiAccess

Parameters

  • fragment
    A string that contains the level and uiAccess values. For more information, see the Remarks section later in this topic.

  • _level
    One of asInvoker, highestAvailable, or requireAdministrator. Defaults to asInvoker. For more information, see the Remarks section later in this topic.

  • _uiAccess
    true if you want the application to bypass user interface protection levels and drive input to higher permission windows on the desktop (such as an on-screen keyboard); otherwise, false. Defaults to false. Set to true only for user interface accessibility applications.

Remarks

If you specify multiple /MANIFESTUAC options on the command-line, the last one entered takes precedence.

The choices for /MANIFESTUAC:level are as follows:

  • asInvoker: The application will run with the same permissions as the process that started it. The application can be elevated to a higher permission level by selecting Run as Administrator.

  • highestAvailable: The application will run with the highest permission level that it can. If the user who starts the application is a member of the Administrators group, this option is the same as requireAdministrator. If the highest available permission level is higher than the level of the opening process, the system will prompt for credentials.

  • requireAdministrator: The application will run with administrator permissions. The user who starts the application must be a member of the Administrators group. If the opening process is not running with administrative permissions, the system will prompt for credentials.

You can specify the level and uiAccess values in one step by using the /MANIFESTUAC:fragment option. The fragment must be in the following form:

"level=[ asInvoker | highestAvailable | requireAdministrator ] uiAccess=[ true | false ]"

To set this linker option in the Visual Studio development environment

  1. Open the project's Property Pages dialog box. For details, see How to: Open Project Property Pages.

  2. Expand the Configuration Properties node.

  3. Expand the Linker node.

  4. Select the Manifest File property page.

  5. Modify the Enable User Account Control (UAC), UAC Execution Level, and UAC Bypass UI Protection properties.

To set this linker option programmatically

See Also

Reference

Setting Linker Options

Linker Options

Change History

Date

History

Reason

July 2008

Removed incorrect information.

Content bug fix.