Merge pull request #2960 from corob-msft/docs/corob/2262

ttorble · web-flow · commit 52b7d6cd5ed7 · 2020-06-24T09:37:11.000+01:00
Update /MANIFESTUAC linker opt per 2262
diff --git a/docs/build/reference/manifestuac-embeds-uac-information-in-manifest.md b/docs/build/reference/manifestuac-embeds-uac-information-in-manifest.md
@@ -1,6 +1,6 @@
 ---
 title: "/MANIFESTUAC (Embeds UAC information in manifest)"
-ms.date: "11/04/2016"
+ms.date: "06/12/2020"
 f1_keywords: ["VC.Project.VCLinkerTool.UACUIAccess", "VC.Project.VCLinkerTool.UACExecutionLevel", "VC.Project.VCLinkerTool.EnableUAC"]
 helpviewer_keywords: ["/MANIFESTUAC linker option", "MANIFESTUAC linker option", "-MANIFESTUAC linker option"]
 ms.assetid: 2d243c39-fa13-493c-b56f-d0d972a1603a
@@ -11,52 +11,51 @@ Specifies whether User Account Control (UAC) information is embedded in the prog
 
 ## Syntax
 
-```
-/MANIFESTUAC
-/MANIFESTUAC:NO
-/MANIFESTUAC:fragment
-/MANIFESTUAC:level=_level
-/MANIFESTUAC:uiAccess=_uiAccess
-```
+> **`/MANIFESTUAC`**\
+> **`/MANIFESTUAC:NO`**\
+> **`/MANIFESTUAC:`**_`level`_\
+> **`/MANIFESTUAC:`**_`uiAccess`_\
+> **`/MANIFESTUAC:`**_`fragment`_
 
 ### Parameters
 
-*fragment*<br/>
-A string that contains the `level` and `uiAccess` values. For more information, see the Remarks section later in this topic.
+**`NO`**<br/>
+The linker doesn't embed UAC information in the program manifest.
 
-*_level*<br/>
-One of *asInvoker*, *highestAvailable*, or *requireAdministrator*. Defaults to asInvoker. For more information, see the Remarks section later in this topic.
+*`level`*<br/>
+**`level=`** followed by one of **`'asInvoker'`**, **`'highestAvailable'`**, or **`'requireAdministrator'`**. Defaults to **`'asInvoker'`**. For more information, see the [Remarks](#remarks) section.
 
-*_uiAccess*<br/>
-**true** if you want the application to bypass user interface protection levels and drive input to higher-permission windows on the desktop; otherwise, **false**. Defaults to **false**. Set to **true** only for user interface accessibility applications.
+*`uiAccess`*<br/>
+**`uiAccess='true'`** if you want the application to bypass user interface protection levels and drive input to higher-permission windows on the desktop; otherwise, **`uiAccess='false'`**. Defaults to **`uiAccess='false'`**. Set this argument to **`uiAccess='true'`** only for user interface accessibility applications.
+
+*`fragment`*<br/>
+A string that contains the *`level`* and *`uiAccess`* values. May optionally be enclosed in double quotes. For more information, see the [Remarks](#remarks) section.
 
 ## Remarks
 
-If you specify multiple /MANIFESTUAC options on the command-line, the last one entered takes precedence.
+If you specify multiple **`/MANIFESTUAC`** options on the command-line, the last one entered takes precedence.
 
-The choices for /MANIFESTUAC:level are as follows:
+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**.
+- **`level='asInvoker'`**: The application runs at the same permission level as the process that started it. You can elevate the application 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.
+- **`level='highestAvailable'`**: The application runs at 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 **`level='requireAdministrator'`**. If the highest available permission level is higher than the level of the opening process, the system prompts 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.
+- **`level='requireAdministrator'`**: The application runs using administrator permissions. The user who starts the application must be a member of the Administrators group. If the opening process isn't running with administrative permissions, the system prompts 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:
+You can specify both 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 ]"
-```
+> **`/MANIFESTUAC:`** \[ **`"`** ] **`level=`** { **`'asInvoker'`** | **`'highestAvailable'`** | **`'requireAdministrator'`** } **`uiAccess=`** { **`'true'`** | **`'false'`** } \[ **`"`** ]
 
-### To set this linker option in the Visual Studio development environment
+For example:
 
-1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md).
+**`/MANIFESTUAC:"level='highestAvailable' uiAccess='true'"`**
 
-1. Expand the **Configuration Properties** node.
+### To set this linker option in the Visual Studio development environment
 
-1. Expand the **Linker** node.
+1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md).
 
-1. Select the **Manifest File** property page.
+1. Select the **Configuration Properties** > **Linker** > **Manifest File** property page.
 
 1. Modify the **Enable User Account Control (UAC)**, **UAC Execution Level**, and **UAC Bypass UI Protection** properties.
 
