在什么情况下RmGetList return 2 为lpdwRebootReasons 输出参数?

Under what conditions does RmGetList return 2 for the lpdwRebootReasons output parameter?

背景

我正在设计一个 Inno Setup 安装程序来安装 Cygwin service, and I am puzzled by the behavior I'm seeing from the Windows Restart Manager API。

具体来说,当服务为 运行(使用 cygrunsrv 实用程序启动)时,RmGetList API function returns 2 (RmRebootReasonSessionMismatch) for its lpdwRebootReasons output parameter. This output parameter is an enumeration of type 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),没有终端 server/remote 桌面用户是已登录。

如果我停止服务并启动另一个可执行文件(在安装程序要替换的文件集中),RmGetList returns 0 (RmRebootReasonNone) for lpdwRebootReasons, Inno Setup 显示正在使用的文件的正常对话框,并允许用户 select 自动关闭它们。

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

问题

  1. 在什么条件下RmGetList return 2 (RmRebootReasonSessionMismatch)为其lpdwRebootReasons输出参数? (我试图理解为什么当服务为 运行 时会发生这种情况。)

  2. 此值是否会导致整个 Restart Manager 会话失败,或者即使它认为应用程序 运行 在一个或多个不同的会话中,Restart Manager 仍可以继续?

关于问题2,在文档中RM_PROCESS_INFO

bRestartable

TRUE if the application can be restarted by the Restart Manager; otherwise, FALSE. This member is always TRUE if the process is a service. This member is always FALSE if the process is a critical system process.

此值表示应用程序是否可以由重新启动管理器重新启动。

对于问题1,注意服务是运行ning在session 0中,如果占用资源的进程(在RmRegisterResources注册)是服务A,RmGetList函数这也在服务进程 B 中 运行ning 将 return lpdwRebootReasons = RmRebootReasonNone, bRestartable = TRUE

但是如果 A 不是服务,那么 A 和 B 在不同的会话中 运行ning,lpdwRebootReasons = RmRebootReasonSessionMismatchbRestartable = FALSE

其他结果:(B 运行 具有提升的权限)

  • A&B为控制台且在同一会话中:lpdwRebootReasons = RmRebootReasonNonebRestartable = TRUEApplicationType = RmConsole
  • A&B是控制台,在不同的会话中:lpdwRebootReasons = RmRebootReasonSessionMismatchbRestartable = FALSEApplicationType = RmConsole
  • A:服务,B:控制台:lpdwRebootReasons = RmRebootReasonNonebRestartable = TRUEApplicationType = RmService

(B 不是 运行 具有提升的权限):

  • A&B是一个console,在不同的session:lpdwRebootReasons = RmRebootReasonCriticalProcess,bRestartable = FALSE,ApplicationType = RmCritical
  • A:服务,B:控制台:lpdwRebootReasons = RmRebootReasonPermissionDeniedbRestartable = FALSEApplicationType = RmCritical

根据文档 bRestartable 取决于 ApplicationType。然后,我们可以看到如果bRestartable = TRUE,那么lpdwRebootReasons = RmRebootReasonNone。但是当bRestartable = FALSE时,这取决于其他成员RM_PROCESS_INFO

来自 RestartManager PowerShell 模块的线索

RestartManager PowerShell module (special thanks to 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 服务进程视为可重启,但它生成的可执行文件不可重启。 (我仍然很好奇为什么会发生这种情况。)

一次不完美的变通尝试

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

  1. 在 Inno Setup 脚本的 [Setup] 部分中,设置以下内容:

     CloseApplications=yes
     CloseApplicationsFilter=*.chm,*.pdf
     RestartApplications=yes
    

    CloseApplicationsFilter 指令指定哪些文件在重新启动管理器中注册。注意我没有在这里指定 *.exe*.dll;我只想在 [Code] 部分中手动指定某些 .exe 文件。

  2. 为设置中的每个 .exe 文件调用 Inno Setup RegisterExtraCloseApplicationsResource 函数一次,这些文件不会被 cygrunsrv 生成并将它们放入 RegisterExtraCloseApplicationsResources 事件过程。示例:

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

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

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

更好的解决方案

我认为更好的解决方案是从代码中检测任何 运行 可执行文件并提示用户,除了重启管理器功能(简单地说,它不适用于 Cygwin 服务)。