新闻详情

新闻详情

首页 / 资讯中心 / 详情

Inno Setup如何调用C DLL?HS2-HF_Patch的DllExport与stdcall导出机制深度剖析

发布时间:2026/11/17 12:54:46来源:尧图网络
Inno Setup如何调用C DLL?HS2-HF_Patch的DllExport与stdcall导出机制深度剖析
Inno Setup如何调用C# DLLHS2-HF_Patch的DllExport与stdcall导出机制深度剖析【免费下载链接】HS2-HF_PatchAutomatically translate, uncensor and update HoneySelect2!项目地址: https://gitcode.com/gh_mirrors/hs/HS2-HF_Patch在开源项目 HS2-HF_PatchHF Patch for HoneySelect2一款自动翻译、去审查并更新 HoneySelect2 的补丁工具中安装器由 Inno Setup 编写而复杂的文件校验、权限修复、插件备份等逻辑全部放在一个 C# DLL 里完成。本文带你弄清 Inno Setup 调用 C# DLL 的完整机制DllExport 属性导出 stdcall 调用约定声明以及这个真实项目中 12 个导出函数是怎么串起来的。为什么安装器要用 C# DLL 干活HF Patch 的安装过程需要不少重活校验安装器自身和分卷文件的 MD5 哈希防止下载损坏从注册表、Steam 目录、全盘扫描三级查找游戏安装位置用takeown/icacls修复游戏目录权限把 BepInEx 插件打包成带时间戳的 zip 备份Inno Setup 自带的 Pascal Script 做这些事比较吃力没有现成的哈希库、zip 压缩、Steam 探测等于是作者把逻辑写成 .NET 程序集HelperLib见 HelperLib/HelperLib.csproj让 Inno Setup 脚本像调用普通 Win32 函数一样调用它。第一步用 DllExport 把静态方法变成导出函数普通 .NET 程序集没有导出表无法被LoadLibrary直接调用。项目的解决方案是 NuGet 包UnmanagedExportsDllExport在 HelperLib/packages.config 中只引用了一个包package idUnmanagedExports version1.2.7 targetFrameworknet45它需要两处配合见 HelperLib/HelperLib.csproj引用RGiesecke.DllExport.Metadata.dll提供DllExport特性导入构建脚本packages/UnmanagedExports.1.2.7/tools/RGiesecke.DllExport.targets编译后自动为标记的方法生成导出表。之后在方法上加一个特性即可对外导出例如 HelperLib/HelperLib.cs 中的[DllExport(FindInstallLocation, CallingConvention CallingConvention.StdCall)] public static void FindInstallLocation(..., out string strout)注意几个硬性要求方法必须是static没有实例可传参数必须全部是托管友好的类型字符串、数字、bool、out 参数返回值建议用out参数传递结果而不是 return。第二步stdcall 调用约定两边必须一致这是最容易踩的坑。x86 上 stdcall 与 cdecl 的栈清理方不同约定不一致会导致栈指针错乱、安装器当场崩溃。C# 侧在特性里指定CallingConvention.StdCall见 HelperLib/HelperLib.csInno Setup 侧在 patch.iss 中用external声明末尾必须写stdcallprocedure FindInstallLocation(path: String; gameName: String; gameNameSteam: String; out strout: WideString); external FindInstallLocationfiles:HelperLib.dll stdcall;声明格式是函数名DLL路径 调用约定。files:HelperLib.dll表示取安装器文件所在目录里的 DLL。整个 patch.iss 一共以这种方式声明了 12 个函数FindInstallLocation、VerifyFiles、SetConfigDefaults、WriteVersionFile、FixConfig、FixPermissions、CreateBackup、RemoveModsExceptModpacks、RemoveSideloaderDuplicates、RemoveNonstandardListfiles、PostInstallCleanUp、RemoveJapaneseCards。字符串怎么传字符集必须对齐Inno Setup 的String内部是 UTF-16 宽字符C# 侧若按 ANSI 解析就会乱码。项目的做法是输入字符串统一标注[MarshalAs(UnmanagedType.LPWStr)]即宽字符串指针输出参数用[MarshalAs(UnmanagedType.BStr)] out string即 COM BSTRPascal Script 侧对应out strout: WideString。以自动探测安装目录为例HelperLib/HelperLib.csFindInstallLocation按顺序尝试三级策略先查注册表Software\illusion\{游戏名}上次打补丁时写入的INSTALLDIR_HFP再查 Steam 各steamapps/common目录实现见 HelperLib/Steam.cs最后对 Program Files 和所有磁盘根目录做暴力扫描。调用点就在 patch.iss 的GetDefaultDirName通过DefaultDirName{code:GetDefaultDirName}让安装向导的目录框直接填好正确路径。一个亮点DLL 根本没打包进安装器patch.iss 中 HelperLib.dll 的 Files 条目带了dontcopy标志Source: HelperLib.dll; DestDir: {app}; Flags: dontcopy意思是编译时把 DLL 塞进安装器但安装到游戏目录时不释放它——它留在安装器临时目录供files:HelperLib.dll在运行期加载任务结束后随临时文件一起消失。这样游戏目录里不会残留一个无用的 DLL卸载时也无从删起。12 个导出函数在流程中的分工阶段函数作用选择目录FindInstallLocation三级探测游戏安装位置安装前VerifyFiles校验 exe 末尾嵌入的 MD5 哈希表HelperLib/Verifier.cs安装前FixPermissions生成批处理执行 takeown/icacls安装前CreateBackup把 BepInEx、scripts、DHH_Data 打包成 zip安装前RemoveModsExceptModpacks旧 Mod 移入备份目录安装后FixConfig校验 setup.xml损坏则重写为安全默认值安装后WriteVersionFile写隐藏的版本记录文件其中VerifyFiles的设计很巧妙哈希表就嵌在安装器 exe 的最后 1000 字节里标记为|HASHES|C# 代码先截取尾部读出期望哈希再对主体重新计算 MD5 比对HelperLib/Verifier.cs。Inno Setup 侧在PrepareToInstall中调用它返回非空错误信息时安装向导自动中止patch.iss。新手最容易踩的 5 个坑调用约定不一致C# 侧StdCall、Inno Setup 侧漏写stdcall表现为安装器莫名崩溃或返回垃圾值字符集不匹配忘了LPWStr标注路径含中文或空格时参数被截断导出非 static 方法DllExport 编译期直接报错异常穿透到非托管C# 异常抛回 Inno Setup 会导致未处理崩溃所以项目里每个导出函数都整包try/catch错误写入HF_Patch_log.txtHelperLib/HelperLib.cs目标机器缺 .NET 4.5DLL 是 .NET 程序集机器上没有对应框架就会加载失败HF Patch 面向的游戏用户环境基本都有但自己项目要评估。小结Inno Setup 调用 C# DLL 的完整链路可以浓缩为四步NuGet 安装UnmanagedExports在 csproj 中引用元数据程序集并导入 targets方法上加[DllExport(导出名, CallingConvention.StdCall)]Inno Setup 中procedure ...; external 导出名files:xxx.dll stdcall;字符串统一宽字符LPWStr/WideString输出走BStr或宽字符串指针。想深入看完整实现推荐按顺序阅读 patch.iss声明与调用、HelperLib/HelperLib.cs导出函数实现和 HelperLib/Verifier.cs哈希校验再对照 README.md 了解这套机制服务的整体补丁流程。【免费下载链接】HS2-HF_PatchAutomatically translate, uncensor and update HoneySelect2!项目地址: https://gitcode.com/gh_mirrors/hs/HS2-HF_Patch创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

【外设】之大彩串口显示屏 2026/11/17 7:04:08

【外设】之大彩串口显示屏

大彩串口屏初步使用 1 .官网下载 STM32 屏幕 GUI 设计资料 http://www.gz-dc.com/category/typeid/4112 找到 STM32 Keil 工程,移植相关代码因项目而异进行移植,由于项目简单,本人只对用到的指令接口进行修改。 比如:注意事项&…

阅读更多 →
无法下载Windows系统iso文件 2026/11/17 5:42:44

无法下载Windows系统iso文件

当我遇到这个问题的时候,我打开了一个网站: 登录 然后我打算下载的时候: 突然那个官方的连接就可以下载了:

阅读更多 →
【清华代码熊】DeepSeek V4.1 Flash 后训练详解 2026/11/17 19:43:34

【清华代码熊】DeepSeek V4.1 Flash 后训练详解

📌 上期解析了 DeepSeek V4.1 Flash 模型架构改进,本期解析 DeepSeek V4.1 Flash 预训练/后训练技术: 🌟 预训练:45T 文本 多模态混合语料、直接训练 sparse attention(取消 DeepSeek V4 的 dense 冷启动&…

阅读更多 →
Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ... 2026/11/17 6:55:04

Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ...

文章主要内容和创新点 主要内容 本文聚焦于多模态大语言模型(MLLM)强化学习(RL)训练中的效率问题,提出了一个名为Shuffle-R1的框架。研究发现,当前RL训练存在两个关键缺陷: 优势值坍缩(Advantage Collapsing):批次中大多数优势值集中在零附近,导致有效梯度信号被淹…

阅读更多 →
PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction 2026/11/17 5:57:47

PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction

一、文章主要内容总结 本文聚焦于利用大型语言模型(LLMs)实现个人身份信息(PII)脱敏的研究,旨在解决传统脱敏方法(如基于规则的系统、领域特定命名实体识别(NER)模型)泛化能力差、跨格式/跨语境适应性弱的问题。 研究通过全面评估多种LLM架构(包括密集型LLM(D-LLM…

阅读更多 →
LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model 2026/11/17 19:43:32

LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model

文章主要内容和创新点 主要内容 本文聚焦于二进制图像-文本相关性评估任务(判断图像与文本“相关”或“不相关”),针对该任务中文本格式多样、相关性定义随场景变化等挑战,提出了基于多模态大语言模型(MLLM)的解决方案LLaVA-RE。 模型设计:LLaVA-RE基于LLaVA 1.5架构,…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉