在什么情况下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
及其启动的进程)运行。两者都是控制台子系统可执行文件。
问题
在什么条件下RmGetList return 2 (RmRebootReasonSessionMismatch
)为其lpdwRebootReasons
输出参数? (我试图理解为什么当服务为 运行 时会发生这种情况。)
此值是否会导致整个 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 = 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是一个console,在不同的session:
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
。
来自 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
服务进程视为可重启,但它生成的可执行文件不可重启。 (我仍然很好奇为什么会发生这种情况。)
一次不完美的变通尝试
基于这种观察到的行为,我首先尝试了以下解决方法:
在 Inno Setup 脚本的 [Setup]
部分中,设置以下内容:
CloseApplications=yes
CloseApplicationsFilter=*.chm,*.pdf
RestartApplications=yes
CloseApplicationsFilter
指令指定哪些文件在重新启动管理器中注册。注意我没有在这里指定 *.exe
或 *.dll
;我只想在 [Code]
部分中手动指定某些 .exe
文件。
为设置中的每个 .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 服务)。
背景
我正在设计一个 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
及其启动的进程)运行。两者都是控制台子系统可执行文件。
问题
在什么条件下RmGetList return 2 (
RmRebootReasonSessionMismatch
)为其lpdwRebootReasons
输出参数? (我试图理解为什么当服务为 运行 时会发生这种情况。)此值是否会导致整个 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 = 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是一个console,在不同的session:
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
。
来自 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
服务进程视为可重启,但它生成的可执行文件不可重启。 (我仍然很好奇为什么会发生这种情况。)
一次不完美的变通尝试
基于这种观察到的行为,我首先尝试了以下解决方法:
在 Inno Setup 脚本的
[Setup]
部分中,设置以下内容:CloseApplications=yes CloseApplicationsFilter=*.chm,*.pdf RestartApplications=yes
CloseApplicationsFilter
指令指定哪些文件在重新启动管理器中注册。注意我没有在这里指定*.exe
或*.dll
;我只想在[Code]
部分中手动指定某些.exe
文件。为设置中的每个
.exe
文件调用 Inno SetupRegisterExtraCloseApplicationsResource
函数一次,这些文件不会被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 服务)。