为EXE/DLL添加版本信息，奋战至深夜

作者：liigo

原文链接：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如下图所示：