原文链接:http://blog.csdn.net/liigo/archive/2008/12/06/3460565.aspx
转载请注明出处:http://blog.csdn.net/liigo/
所谓PE文件版本信息,本文最后有幅图,看了就很明了了。
为EXE/DLL添加版本信息,总体思路很简单,就是自行生成特定格式的资源数据,调用Win32API函数UpdateResource将该数据写入文件中即可(或者由编译器在输出文件时插入该数据)。
关 键是这一段数据的生成,相对比较复杂,而且繁索,不小心就还容易出错。这是一块纯数据(raw data),格式比较复杂,结构体嵌套N层,而这些个结构体的结构又不是固定不变的,用C语言根本无法描述,MSDN中也还要同时借助于自然语言才能表 达。首先,最顶层是一个VS_VERSIONINFO结构,它包含一个成员VS_FIXEDFILEINFO,并且有两个子成员 StringFileInfo和VarFileInfo;其中,StringFileInfo要包含一个子成员StringTable(外加 StringTable内N个子成员String),VarFileInfo要包含子成员Var。以上提到的各子成员,都分别是一个格式不固定的结构体, 组织这些数据时必须处理字节对齐问题。
无论如何,MSDN中的资料相对完整,细心耐心一些,总是可以完成这个工作。
我之所以奋战至深夜,是因为遇到几个一时无法解决的细节问题。写在这里,希望对其他人有点参考价值。
第一个问题:必须存在“文件版本”
StringFileInfo结构中的StringTable结构中必须包含一个KEY为“FileVersion”的String,否则,设定的其它所有版本信息项一定不会显示出来。
这 也许是微软的BUG吧,或者说是MSDN上的疏漏,没有写明。这个问题真是可恨,我(liigo)当时测试只是随便选了几项(如 CompanyName,ProductName)写入,结果死活显示不出来,把我的代码检查了一遍又一遍,与MSDN中的说明逐一核对,最后死活也想不 到是因为少写了FileVersion这么一项数据。我奋战至深夜,绝大部分时间用于总结出这么一条令人沮丧的沉痛经验!
第二个问题:“语言”
StringFileInfo 结构中的StringTable结构中的szKey成员,表示语言信息,MSDN中的说明不是很具体,我对比参考其它已经写入版本信息的EXE,得知 L"080404B0"表示“中文(中国)”,L"040904E4"表示“英语(美国)”。(当然还要相应的设置VarFileInfo结构中的Var 结构中的Value数值。如果没有VarFileInfo结构,或VarFileInfo.Var.Value值不对,版本信息也不会显示出来。)
第三个问题:字节对齐
以 上提到的所有结构体中,通常都有一到两个Padding成员,用于将下一个成员对齐到32字节位边界,这在MSDN中说明的比较明确。我(liigo)要 特别指出的是,在String结构中,MSDN定义中只在Value成员之前有一个Padding,用于将Value对齐到32位边界,其实在Value 成员之后也应该有一个Padding。因为多个String是邻接存放的,前一个String.Value可能会导致后一个String.Value无法 对齐到32位边界,这里需要特别注意。另,MSDN中明确说明,VS_VERSIONINFO中的wLength成员“不包含”本结构及其子结构的所有 Padding的长度,而我实际测试中发现,即使包含了所有Padding的长度,结果也是正确的,——去掉所有Padding的长度是需要额外的处理 的,我这里偷懒了。
第四个问题:VS_FIXEDFILEINFO中的无详细文档成员
VS_FIXEDFILEINFO 结构中的dwStrucVersion和dwFileFlagsMask,MSDN中并未具体说明应该给什么值,我随便给了0,经测试是可以的。该结构中 的dwFileDateMS和dwFileDateLS,MSDN要求给予文件写入时间,经测试用0也是可以的,这里又偷懒了,呵呵。
右键属性查看添加了版本信息的易语言主程序e.exe如下图所示: