WPF嵌入MSI UI修改功能请求状态遇“句柄无效”异常求助

问题背景 #

基于WPF的嵌入式UI MSI安装程序（WiX 3.14、.NET Framework 4.8、Win11），其余功能正常，但无法修改功能请求状态：

• 调用Session.Features获取功能集合时，抛出**"The handle is invalid"**异常
• 尝试调用Session.SetInstallLevel(installLevel)设置安装级别，仍抛相同异常
• 通过Session.DoAction()依次调用CostInitialize、FileCost、CostFinalize启动成本计算流程，同样失败
• 尝试通过IEmbeddedUI.ProcessMessage(...)获取功能列表，也抛出相同异常

解决方向 #

1. 确认嵌入式UI的操作时机 #

嵌入式UI的Initialize阶段，MSI Session可能尚未完成功能数据的初始化。不要在Initialize方法中直接访问Session.Features，而是等到收到INSTALLUI_MSG_INITIALIZE消息后再执行功能相关操作——这个阶段MSI已完成基础初始化，Session的功能数据通常已加载。

2. 验证Session实例的有效性 #

• 检查自定义IEmbeddedUI实现中，是否正确保留了Session实例，未被提前释放或在错误的线程中访问。MSI Session并非线程安全，WPF UI的功能操作必须在MSI主线程上下文执行，避免跨线程调用。
• 异常触发时，检查Session.Handle是否为IntPtr.Zero，如果是，说明Session已被MSI引擎回收，需确保UI操作时Session仍处于活跃状态。

3. 改用原生MSI API绕过托管Session限制 #

如果托管的Session.Features始终无法正常工作，尝试通过P/Invoke调用原生MSI API直接操作功能：

[DllImport("msi.dll", CharSet = CharSet.Unicode, PreserveSig = true)]
static extern uint MsiGetFeatureState(IntPtr hInstall, string szFeature, out uint pState);

[DllImport("msi.dll", CharSet = CharSet.Unicode, PreserveSig = true)]
static extern uint MsiSetFeatureState(IntPtr hInstall, string szFeature, uint dwState);

// 获取功能状态
uint featureState;
MsiGetFeatureState(session.Handle, "YourFeatureId", out featureState);

// 设置功能状态（示例：设为本地安装）
const uint INSTALLSTATE_LOCAL = 1;
MsiSetFeatureState(session.Handle, "YourFeatureId", INSTALLSTATE_LOCAL);

4. 检查MSI数据库完整性 #

用Orca工具打开MSI包，验证以下内容：

• Feature表中所有条目的FeatureId、Level字段合法，无空值或无效值
• FeatureComponents表中功能与组件的关联完整，无缺失或错误映射
• InstallExecuteSequence和InstallUISequence中，CostInitialize、FileCost、CostFinalize动作的执行顺序正确，未被意外移除

5. 排查WiX嵌入式UI配置 #

确认WiX项目中EmbeddedUI元素的配置正确：

<EmbeddedUI Id="WpfEmbeddedUI" SourceFile="YourWpfUI.dll" />

确保UI DLL被正确打包进MSI，且类实现IEmbeddedUI接口的命名空间和类名配置无误（若需指定）。

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