发布于 2018-01-21 13:29 更新于 2018-09-01 00:13
Windows 10 创意者更新之后,默认开启了重启后恢复应用程序状态的功能。这是自 Vista 以来就提供的功能——Restart Manager。
应用程序实现这一功能只需要调用 RegisterApplicationRestart
即可。传入两个参数:
我封装了以下这个函数的调用并将其放到 GitHub 上:sharing-demo/ApplicationRestartManager.cs at master · walterlv/sharing-demo。
调用代码如下:
if (ApplicationRestartManager.IsRestartManagerSupported)
{
ApplicationRestartManager.RegisterApplicationRestart(
currentOpeningFile,
ApplicationRestartFlags.None);
}
附:封装的 ApplicationRestartManager
:
using System;
using System.Diagnostics.Contracts;
using System.Runtime.InteropServices;
using System.Windows;
using Jetbrains.Annotations;
namespace Walterlv.Win32
{
/// <summary>
/// 为应用程序提供重启后恢复状态的功能。
/// </summary>
public class ApplicationRestartManager
{
/// <summary>
/// 获取一个值,该值指示当前操作系统环境是否支持 Restart Manager 功能。
/// Restart Manager 是 Windows Vista 新增的功能。在 Windows 10 秋季创意者更新之后,默认开启了 EWX_RESTARTAPPS。
/// </summary>
public static bool IsSupported => IsSupportedLazy.Value;
/// <summary>
/// 向操作系统的 Restart Manager 注册应用终止后的重启方式。
/// </summary>
/// <param name="pwsCommandLine">
/// 应用程序的重启时应该使用的参数,允许为 null,表示不带参数。
/// 请注意:如果命令行参数中的某一个参数包含空格,请加上引号。
/// </param>
/// <param name="dwFlags">为应用程序的重启行为添加限制,默认没有限制。</param>
/// <returns></returns>
public static bool RegisterApplicationRestart(
[CanBeNull] string pwsCommandLine,
ApplicationRestartFlags dwFlags = ApplicationRestartFlags.None)
{
return 0 == RegisterApplicationRestart(pwsCommandLine, (int) dwFlags);
}
/// <summary>
/// Windows Vista 及以上才开启 Restart Manager。
/// </summary>
[ContractPublicPropertyName(nameof(IsSupported))]
private static readonly Lazy<bool> IsSupportedLazy =
new Lazy<bool>(() => Environment.OSVersion.Version >= new Version(6, 0));
/// <summary>
/// Registers the active instance of an application for restart.
/// See also: [RegisterApplicationRestart function (Windows)](https://msdn.microsoft.com/en-us/library/windows/desktop/aa373347)
/// </summary>
/// <param name="pwzCommandline">
/// A pointer to a Unicode string that specifies the command-line arguments for the application when it is restarted. The maximum size of the command line that you can specify is RESTART_MAX_CMD_LINE characters. Do not include the name of the executable in the command line; this function adds it for you.
/// If this parameter is NULL or an empty string, the previously registered command line is removed. If the argument contains spaces, use quotes around the argument.
/// </param>
/// <param name="dwFlags">
/// This parameter can be 0 or one or more of the following values:
/// - 1: Do not restart the process if it terminates due to an unhandled exception.
/// - 2: Do not restart the process if it terminates due to the application not responding.
/// - 4: Do not restart the process if it terminates due to the installation of an update.
/// - 8: Do not restart the process if the computer is restarted as the result of an update.
/// </param>
/// <returns>
/// This function returns S_OK on success or one of the following error codes.
/// - E_FAIL: Internal error.
/// - E_INVALIDARG: The specified command line is too long.
/// </returns>
[DllImport("kernel32.dll", CharSet = CharSet.Auto)]
private static extern uint RegisterApplicationRestart(string pwzCommandline, int dwFlags);
}
/// <summary>
/// 表示重启时的限制标记。
/// </summary>
[Flags]
public enum ApplicationRestartFlags
{
/// <summary>
/// 没有重启限制。如果仅指定 <see cref="None"/>,那么操作系统在可以重启应用程序的时候都会重启应用。
/// </summary>
None = 0,
/// <summary>
/// 指定此时不重启:因未处理的异常而导致进程停止工作。
/// </summary>
RestartNoCrash = 1,
/// <summary>
/// 指定此时不重启:因应用程序无响应而导致进程停止工作。
/// </summary>
RestartNoHang = 2,
/// <summary>
/// 指定此时不重启:因应用安装更新导致进程关闭。
/// </summary>
RestartNoPatch = 4,
/// <summary>
/// 指定此时不重启:因操作系统安装更新后重启导致进程关闭。
/// </summary>
RestartNoReboot = 8
}
}
本文会经常更新,请阅读原文: https://walterlv.com/post/application-restart-manager.html ,以避免陈旧错误知识的误导,同时有更好的阅读体验。
本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布,但务必保留文章署名 吕毅 (包含链接: https://walterlv.com ),不得用于商业目的,基于本文修改后的作品务必以相同的许可发布。如有任何疑问,请 与我联系 (walter.lv@qq.com) 。