Wix Toolset：系统重启后如何继续完成安装流程

优先使用Windows Installer内置机制（Wix原生支持） #

Wix基于Windows Installer构建，后者本身就提供了重启替换锁定文件的原生能力，完全不需要手动处理临时文件和注册表触发，这是最规范可靠的方案：

• 标记锁定文件：在File元素中设置Vital="yes"和KeyPath="yes"，Windows Installer检测到文件被系统占用时，会自动将其加入重启后替换队列，无需额外操作：

<Component Id="LockedFileComponent" Guid="*" Directory="INSTALLFOLDER">
  <File Id="LockedFile.exe" Source="Assets\LockedFile.exe" Vital="yes" KeyPath="yes" />
</Component>

• 控制重启时机：如果需要强制重启（而非让Installer自动判断），可以在InstallExecuteSequence中添加ScheduleReboot元素：

<InstallExecuteSequence>
  <!-- 安装完成后触发重启 -->
  <ScheduleReboot After="InstallFinalize" />
</InstallExecuteSequence>

如果不手动添加，Windows Installer会在检测到需要替换锁定文件时，自动提示用户重启系统。

自定义临时文件+注册表方案（特殊场景下使用） #

如果因业务需求必须手动处理临时文件，可利用Windows内置的PendingFileRenameOperations注册表项实现重启后文件替换：

1. 安装过程中将待替换文件复制到临时目录（比如C:\Windows\Temp\TempLockedFile.exe）
2. 通过Wix自定义动作，向HKLM\SYSTEM\CurrentControlSet\Control\Session Manager下的PendingFileRenameOperations多字符串值添加操作指令：
   • 指令格式为成对的字符串：第一行是临时文件的完整路径（前缀\??\），第二行是目标文件路径（同样带\??\前缀）
   • 示例Wix配置：

<!-- 注册自定义动作 -->
<Binary Id="CustomActionsDll" SourceFile="bin\CustomActions.dll" />
<CustomAction Id="SetPendingRename" Execute="deferred" Impersonate="no" BinaryKey="CustomActionsDll" DllEntry="SetPendingFileRename" />

<!-- 安排自定义动作执行时机 -->
<InstallExecuteSequence>
  <Custom Action="SetPendingRename" After="InstallFiles" />
</InstallExecuteSequence>

• 对应的C++自定义动作核心代码：

UINT __stdcall SetPendingFileRename(MSIHANDLE hInstall)
{
    HKEY hSessionManagerKey = nullptr;
    LSTATUS status = RegOpenKeyExW(
        HKEY_LOCAL_MACHINE,
        L"SYSTEM\\CurrentControlSet\\Control\\Session Manager",
        0,
        KEY_SET_VALUE,
        &hSessionManagerKey
    );

    if (status == ERROR_SUCCESS)
    {
        // 注意：多字符串值以双空字符结尾
        const wchar_t* pendingOps = L"\\??\\C:\\Windows\\Temp\\TempLockedFile.exe\0\\??\\C:\\Program Files\\MyApp\\LockedFile.exe\0\0";
        status = RegSetValueExW(
            hSessionManagerKey,
            L"PendingFileRenameOperations",
            0,
            REG_MULTI_SZ,
            (const BYTE*)pendingOps,
            (wcslen(pendingOps) + 1) * sizeof(wchar_t)
        );
        RegCloseKey(hSessionManagerKey);
    }
    return ERROR_SUCCESS;
}

关于Wix文档的说明 #

你在Wix文档中没找到相关内容，是因为这属于Windows Installer的核心功能，Wix只是封装了该机制，相关细节可参考Windows Installer官方文档，而非Wix专属文档。

内容的提问来源于stack exchange，提问作者Haicon