【问题标题】：Under what conditions does RmGetList return 2 for the lpdwRebootReasons output parameter?在什么情况下 RmGetList 为 lpdwRebootReasons 输出参数返回 2？
【发布时间】：2020-05-11 02:53:53
【问题描述】：

背景

我正在设计一个 Inno Setup 安装程序来安装 Cygwin 服务，我对从 Windows Restart Manager API 看到的行为感到困惑。

具体来说，当服务正在运行时（使用cygrunsrv 实用程序启动），RmGetList API 函数为其lpdwRebootReasons 输出参数返回 2 (RmRebootReasonSessionMismatch)。这个输出参数是RM_REBOOT_REASON类型的枚举，MSDN上对RmRebootReasonSessionMismatch值的描述是：

One or more processes are running in another Terminal Services session.

Inno Setup 日志文件包含如下行：

RestartManager found an application using one of our files: <executable name>
RestartManager found an application using one of our files: <service name>
Can use RestartManager to avoid reboot? No (2: Session Mismatch)

Inno Setup 然后继续尝试替换正在使用的文件，就好像根本没有使用 Restart Manager。

我对这个输出值感到困惑，因为在我测试的两台不同的机器上（Windows 10 1909 x64 和 Windows Server 2012 R2），没有终端服务器/远程桌面用户登录。

如果我停止服务并启动另一个可执行文件（在要被安装程序替换的文件集中），RmGetList 为lpdwRebootReasons 返回 0 (RmRebootReasonNone)，Inno Setup 显示正常对话框以供使用文件并允许用户选择自动关闭它们。

Process Explorer 显示在会话 0 和 System 完整性级别运行的两个进程（cygrunsrv.exe 及其启动的进程）。两者都是控制台子系统可执行文件。

问题

在什么情况下，RmGetList 的lpdwRebootReasons 输出参数返回2 (RmRebootReasonSessionMismatch)？（我试图理解为什么在服务运行时会发生这种情况。）
此值是否会导致整个 Restart Manager 会话失败，或者即使 Restart Manager 认为应用程序正在一个或多个不同的会话中运行，它仍可以继续吗？

【问题讨论】：

请注意，服务正在会话 0 中运行。您从 RM_PROCESS_INFO 获得的进程是否在另一个会话中运行？您可以在 cmd 中运行tasklist 来检查进程和会话信息。
查看更新。进程（cygrunsrv 及其启动的进程）在会话 0 中以 System 完整性级别运行。两者都是控制台。

标签： winapi cygwin inno-setup restartmanager windows-restart-manager

【解决方案1】：

对于问题2，在文档RM_PROCESS_INFO

b可重启

TRUE 如果应用程序可以通过重新启动管理器重新启动；否则，错误。如果进程是一个服务。如果进程很关键，则此成员始终为 FALSE 系统进程。

此值指示应用程序是否可以通过重新启动管理器重新启动。

对于问题1，注意服务在会话0中运行。如果占用资源的进程（注册在RmRegisterResources中）是服务A，同样运行在服务进程B中的RmGetList函数将返回@ 987654325@，bRestartable = TRUE。

但如果 A 不是服务，那么 A 和 B 运行在不同的会话中，lpdwRebootReasons = RmRebootReasonSessionMismatch 和 bRestartable = FALSE

其他结果：（B以提升的权限运行）

A & B 是一个控制台并且在同一个会话中：lpdwRebootReasons = RmRebootReasonNone, bRestartable = TRUE, ApplicationType = RmConsole。
A & B 是一个控制台，在不同的会话中：lpdwRebootReasons = RmRebootReasonSessionMismatch, bRestartable = FALSE, ApplicationType = RmConsole。
A：服务，B：控制台：lpdwRebootReasons = RmRebootReasonNone，bRestartable = TRUE，ApplicationType = RmService

（B 没有以提升的权限运行）：

A & B 是一个控制台，在不同的会话中：lpdwRebootReasons = RmRebootReasonCriticalProcess, bRestartable = FALSE, ApplicationType = RmCritical。
A：服务，B：控制台：lpdwRebootReasons = RmRebootReasonPermissionDenied，bRestartable = FALSE，ApplicationType = RmCritical

根据文档bRestartable 依赖于ApplicationType。然后，我们可以看到如果bRestartable = TRUE，那么lpdwRebootReasons = RmRebootReasonNone。但是bRestartable = FALSE的时候，就要看其他成员RM_PROCESS_INFO了。

【讨论】：

【解决方案2】：

RestartManager PowerShell 模块的线索

RestartManager PowerShell module（特别感谢Heath Stewart）为重启管理器提供了一个简单的 PowerShell 界面。我的命令如下：

Set-Location <path to Cygwin root directory>
Start-RestartManagerSession
Get-ChildItem . -File -Include *.exe,*.dll -Recurse | RegisterRestartManagerResource
Get-RestartManagerProcess
Stop-RestartManagerProcess

这些命令产生以下输出：

Id                : <process ID>
StartTime         : <process start time>
Description       : <executable started by cygrunsrv>
ServiceName       :
ApplicationType   : Console
ApplicationStatus : Running
IsRestartable     : False
RebootReason      : SessionMismatch

Id                : <cygrunsrv process id>
StartTime         : <cygrunsrv process start time>
Description       : <description of service>
ServiceName       : <service name>
ApplicationType   : Service
ApplicationStatus : Running
IsRestartable     : True
RebootReason      : SessionMismatch

由于某种原因，重新启动管理器将cygrunsrv.exe 服务进程视为可重新启动，但它生成的可执行文件不可重新启动。（我仍然很好奇为什么会发生这种情况。）

不完美的解决方法尝试

基于这种观察到的行为，我首先尝试了以下解决方法：

在 Inno Setup 脚本的 [Setup] 部分中，设置以下内容：
```
 CloseApplications=yes
 CloseApplicationsFilter=*.chm,*.pdf
 RestartApplications=yes
```
CloseApplicationsFilter 指令指定哪些文件注册到重新启动管理器。注意我这里没有指定*.exe 或*.dll；我只想在[Code] 部分手动指定某些.exe 文件。
为设置中不会由cygrunsrv 生成的每个.exe 文件调用一次Inno Setup RegisterExtraCloseApplicationsResource 函数，并将它们放入RegisterExtraCloseApplicationsResources 事件过程中。示例：
```
 [Code]

 procedure RegisterExtraCloseApplicationsResources();
 begin
   RegisterExtraCloseApplicationsResource(false, ExpandConstant('{app}\bin\cygrunsrv.exe'));
 end;
```

重要的是不要注册由cygrunsrv.exe 或任何 Cygwin DLL 文件生成的任何可执行文件，因为这将阻止重新启动管理器在 Inno Setup 中生效。

此解决方案远非完美，因为通常由 cygrunsrv 启动的可执行文件如果单独启动，则不会被重新启动管理器检测到（例如，sshd.exe）。例如，新的 SSH 会话在重启管理器不可重启的可执行文件中生成。

更好的解决方案

我决定一个更好的解决方案是从代码中检测任何正在运行的可执行文件并提示用户，而不是重新启动管理器功能（简单地说，它不适用于 Cygwin 服务）。

【讨论】：