如果你的程序对 Windows 运行权限有要求,那么需要设置应用程序清单。本文介绍如何添加应用程序清单,并解释其中各项 UAC 权限设置的实际效果。
阅读本文之前,你可能需要了解如何创建应用程序清单文件。阅读我的另一篇博客可以了解:
- 如何创建应用程序清单文件 App.Manifest,如何创建不带清单的应用程序 - 吕毅
各种不同的 UAC 清单选项
从默认生成的应用程序清单中,我们可以很容易的知道有四种不同的设置:
asInvoker
requireAdministrator
highestAvailable
- 删除
requestedExecutionLevel
元素 (不要忘了还可以删除)
当然这里我们是没有考虑 uiAccess
的。你可以阅读我的另一篇博客了解 uiAccess
的一项应用:
- 让 Windows 桌面程序运行在 Windows 应用上面 - 吕毅
asInvoker
父进程是什么权限级别,那么此应用程序作为子进程运行时就是什么权限级别。
默认情况下用户启动应用程序都是使用 Windows 资源管理器(explorer.exe)运行的;在开启了 UAC 的情况下,资源管理器是以标准用户权限运行的。于是对于用户点击打开的应用程序,默认就是以标准用户权限运行的。
如果已经以管理员权限启动了一个程序,那么这个程序启动的子进程也会是管理员权限。典型的情况是一个应用程序安装包安装的时候使用管理员权限运行,于是这个安装程序在安装完成后启动的这个应用程序进程实例就是管理员权限的。有时候这种设定会出现问题,你可以阅读 在 Windows 系统上降低 UAC 权限运行程序(从管理员权限降权到普通用户权限)。
requireAdministrator
此程序需要以管理员权限运行。
在资源管理器中可以看到这样的程序图标的右下角会有一个盾牌图标。
用户在资源管理器中双击启动此程序,或者在程序中使用 Process.Start
启动此程序,会弹出 UAC 提示框。点击“是”会提权,点击“否”则操作取消。
highestAvailable
此程序将以当前用户能获取的最高权限来运行。
这个概念可能会跟前面说的 requireAdministrator
弄混淆。
要更好的理解这两个概念的区别,你可能需要对 UAC 用户账户控制有一个初步的了解,可以阅读我的另一篇博客:
- Windows 中的 UAC 用户账户控制
接下来的内容,都假设你已经了解了上文所述的 UAC 用户账户控制。
如果你指定为 highestAvailable
:
- 当你在管理员账户下运行此程序,就会要求权限提升。资源管理器上会出现盾牌图标,双击或使用
Process.Start
启动此程序会弹出 UAC 提示框。在用户同意后,你的程序将获得完全访问令牌(Full Access Token)。 - 当你在标准账户下运行此程序,此账户的最高权限就是标准账户。受限访问令牌(Limited Access Token)就是当前账户下的最高令牌了,于是
highestAvailable
已经达到了要求。资源管理器上不会出现盾牌图标,双击或使用Process.Start
启动此程序也不会出现 UAC 提示框,此程序将以受限权限执行。
下图是一个例子。lvyi 是我安装系统时创建的管理员账号,但是我使用的是 walterlv 标准账号。正常是在 walterlv 账号下启动程序,但以管理员权限运行时,会要求输入 lvyi 账号的密码来提权,于是就会以 lvyi 的身份运行这个程序。这种情况下,那个管理员权限运行的程序会以为当前运行在 lvyi 这个账户下,程序员需要小心这里的坑,因为拿到的用户路径以及注册表不是你所期望的 walterlv 这个账号下的。
删除 requestedExecutionLevel 元素
删除 requestedExecutionLevel 元素指的是将下面标注的这一行删掉:
1 2 3 4 5 6 7 8 9 | <?xml version="1.0" encoding="utf-8"?><br> <assembly manifestVersion="1.0" xmlns="urn:schemas-microsoft-com:asm.v1"><br> <trustInfo xmlns="urn:schemas-microsoft-com:asm.v2"><br> <security><br> <requestedPrivileges xmlns="urn:schemas-microsoft-com:asm.v3"><br>-- <requestedExecutionLevel level="asInvoker" uiAccess="false" /><br> </requestedPrivileges><br> </security><br> </trustInfo> |
---|
注释中说删除 requestedExecutionLevel
元素将开启 UAC 虚拟化。
我将这个节点删除后,运行我的 Demo 程序后 UAC 虚拟化将启用。默认这里是“已禁用”的。
不过在以下任意一种情况下,UAC 虚拟化即便删了 requestedExecutionLevel
也是不会开启的:
- 64 位进程
- 不可交互的进程(例如服务)
- 进程模拟用户的操作(如果一个进程像用户一样执行了某项操作,那么这个操作不会被虚拟化)
- 驱动等内核模式进程
这部分的列表你可以在这里查询到:Registry Virtualization - Windows applications - Microsoft Docs。
这些值都用于什么场景?
asInvoker
是默认情况下的首选。如果你的程序没有什么特殊的需求,就使用asInvoker
;就算你的程序需要管理员程序做一些特殊的任务,那最好也写成asInvoker
,仅在必要的时候才进行管理员权限提升。requireAdministrator
,只有当你的程序大量进行需要管理员权限的操作的时候才建议使用requireAdministrator
值,例如你正在做安装程序。highestAvailable
,当你的程序需要管理员权限,但又要求仅对当前用户修改时设置为此值。因为标准用户申请 UAC 提权之后会以其他用户的身份运行进程,这就不是对当前用户的操作了;使用highestAvailable
来确保以当前用户运行。
为什么 UWP 程序不能指定 UAC 清单选项?
在我的另一篇博客 Windows 中的 UAC 用户账户控制 中说到了访问令牌。
UWP 程序只能获得受限访问令牌,没得选,所以也就不需要指定 UAC 清单选项了。这也是为什么当你关闭 UAC 之后,UWP 程序将全部闪退的重要原因。
参考资料
- Registry Virtualization - Windows applications - Microsoft Docs
- How User Account Control (UAC) Affects Your Application - Microsoft Docs
本文会经常更新,请阅读原文: https://blog.walterlv.com/post/requested-execution-level-of-application-manifest.html ,以避免陈旧错误知识的误导,同时有更好的阅读体验。
本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布,但务必保留文章署名 吕毅 (包含链接: https://blog.walterlv.com ),不得用于商业目的,基于本文修改后的作品务必以相同的许可发布。如有任何疑问,请 与我联系 ([email protected]) 。