我如何獲得安裝在我的系統上的某個特定的 DLL 的版本信息？我嘗試著確定系統安裝了哪個版本的 comctl32.dll。我見過有些代碼調用 GetProcAddress 來獲取各種函數，如 InitCommonControlsEx，以確定基於不同版本的函數調用。對於我來說，這是一個坎兒，到底用什麼方法獲得版本號？
有兩種方法：容易的和難的。容易的方法是調用一個專門用於此目的的函數 DllGetVersion。問題是雖然 comctl32.dll 支持該函數，但並不是所有的 DLLs 都具備它。如果不具備 DllGetVersion，那麼就得用難的方法——使用 FileVersion API，這可能是你要遭遇到的最為暧昧的 API 之一。我寫了一個類 CModuleVersion 來封裝兩種方法，同時還寫了一個Demo程序 VersionDlg 來示范 CModuleVersion 的使用方法。程序畫面如 Figure 1 所示。你可以在編輯框中敲入任何系統模塊的名字，VersionDlg 將用 DllGetVersion （如果具備這個函數的話）和 FileVersion API 兩種方法顯示版本信息。源代碼參見 Figure 2。
Figure 1 運行中的 VersionDlg 程序
讓我們先看容易的方法。DllGetVersion 用 DLL 版本信息填寫一個 DLLVERSIONINFO 結構。該結構定義在 Win32 SDK 的 showapi.h 頭文件中。許多人可能都沒有安裝 Platform SDK，那麼就得自己定義這個結構了（譯者注：實際上，早期的 Developer Studio 不包含這個頭文件。後來的 Visual Studio 6.0 安裝已經包含該頭文件，路經參見：Driver:\Program Files\Microsoft Visual Studio\VC98\Include），就像我在 VersionDlg 所做的那樣。
typedef struct _DllVersionInfo {
DWORD cbSize;
DWORD dwMajorVersion;
DWORD dwMinorVersion;
DWORD dwBuildNumber;
DWORD dwPlatformID;
} DLLVERSIONINFO;
這個結構中的字段基本不用怎麼說明就知道是什麼意思：dwPlatformID 為 DLLVER_PLATFORM_WINDOWS （value = 1）指 Windows 9x，而 DLLVER_PLATFORM_NT （value = 2）用於 Windows NT。一旦定義了 DLLVERSIONINFO 結構，就可以調用 DllGetVersion 了，該函數的署名如下：
HRESULT DllGetVersion(DLLVERSIONINFO*);
因為並不是任何給定的 Dll 都輸出 DllGetVersion 函數，你得按照標准套路來調用它，即調用 GetProcAddress 並判斷返回值是否為 NULL。我編寫的類 CModuleVersion 中含有一個 DllGetVersion 函數，它把所有細節都進行了封裝（參見 Figure 2 中的 ModulVer.cpp。）CModuleVersion 類的使用方法如下：
DLLVERSIONINFO dvi;
if (CModuleVersion::DllGetVersion("comctl32.dll", dvi))
{
// now info is in dvi
}
DllGetVersion 是一個比較新的函數（譯者注：在1998年是這樣。）對於 comctl32 很好使，因為它實現並輸出 DllGetVersion——但是對於那些不輸出 DllGetVersion 的 DLLs 來說怎麼辦呢？例如：shell32.dll 就沒有實現 DllGetVersion，如 Figure 3 所示。這時你就得用可怕以及奇怪的 GetFileVersionInfo 和 VerQueryValue 函數，它們在 winver.h 中定義。
Figure 3 No DllGetVersion Info
大多數可執行程序和 DLLs 都具備 VS_VERSION_INFO 資源，在模塊的 RC 文件中定義。Figure 4 是 VersionDlg 的 RC 文件中的版本信息。你可以用文本編輯器或者 Visual Studio 直接編輯資源文件中的這段信息。你可以指定文件版本，產品版本等等，以及任何你想要編輯的字段，如：CompanyName、InternalName。文件版本信息與 Exe 或 DLL 文件在資源管理器“屬性”頁“版本”標簽中顯示的信息相同（參見 Figure 5）。
Figure 5 Version Tab
等一會兒你就會發現，這些版本 APIs 十分暧昧，很容易把人搞暈菜，但 CModuleVersion 使一切都變得簡單明了。這個類派生於 VS_FIXEDFILEINFO（參見 Figure 6），此結構包含“固定的”版本信息，其中有主版本號和次版本號，還有一些 DLLVERSIONINFO 裡的東西。使用 CModuleVersion 時，只要像下面這樣寫即可：
CModuleVersion ver;
if (ver.GetFileVersionInfo(_T("comctl32.dll"))
{
WORD major = HIWORD(ver.dwFileVersionMS);
WORD minor = LOWORD(ver.dwFileVersionMS);
...
}
為了存取 CompanyName 這樣的可變信息以及內涵的模塊創建信息，你可以用另外一個函數 CModuleVersion:: GetValue，例如，下面代碼段執行之後，sCompanyName 的值將類似“XYZ”或“Acme Corporation”這樣的公司名稱：
CString sCompanyName =
ver.GetValue(_T("CompanyName"));
CModuleVersion 隱藏了獲取信息所要做的所有邋遢細節——相信我，都是些邋遢細節！如果你只是想使用 CModuleVersion，那麼看到這裡就可以打住了；如果你想要了解 CModuleVersion 的工作原理，那就繼續往下看。
假設 CModuleVersion::GetFileVersionInfo 能加載模塊並獲取 HINSTANCE，它調用 ::GetFileVersionInfoSize 來獲取版本信息的大小，然後分配一個緩沖並調用 GetFileVersionInfo 來填充該緩沖。原始緩沖（CModuleVersion::m_pVersionInfo）是一個數據塊，它包含固定的信息和可變信息。VerQueryValue 將一個指針指向你感興趣的特定信息的起始位置。例如，為了得到固定的信息（VS_FIXEDFILEINFO），你得這樣寫：
LPVOID lpvi;
UINT iLen;
VerQueryValue(buf, _T("\\"), &lpvi, &iLen);
此處 buf 是從 GetFileVersionInfo 返回的完整信息。字符串“\”（在 C 中用“\\”），你如果把它看作是一個目錄，那它就是根信息（有一點像注冊表）。VerQueryValue 將 lpvi 置到 VS_FIXEDFILEINFO 的起始處，iLen 為其長度。
以上是獲取固定信息的方法，可變信息獲取更奇怪，因為你必須首先知道語言 ID 和代碼頁是什麼。在 Winidows 裡，代碼頁指定了一個字符集，它是字符文字與表示它們的 1 或 2 字節值之間映射。標准的 ANSI 代碼頁是 1252；Unicode 是 1200。Figure 7 是語言ID和代碼頁的清單。Figure 4 中文件信息裡的 Translation 鍵指定模塊的語言ID和代碼頁。在 CModuleVersion 中，我使用自己的 Translation 結構來獲取這個信息。
// in CModuleVersion
struct TRANSLATION {
WORD langID // language ID
WORD charset; // code page
} m_translation;
為了獲取語言信息，CModuleVersion 用 VerQueryValue 函數以 \VarFileInfo\Translation 作為鍵。
if (VerQueryValue(m_pVersionInfo,"\\VarFileInfo\\Translation", &lpvi, &iLen) && iLen >= 4)
{
m_translation = *(TRANSLATION*)lpvi;
}
一旦你知道了語言ID和代碼頁，你就可以得到 CompanyName 和 InternalName 這樣的可變信息。實現方法是構造一個如下形式的查詢：
\StringFileInfo\<langID><codepage>\<keyname>
這裡 <langID> 是十六進制 ASCI 形式的語言ID（中文是 0804；US English 是 0409），<codepage> 是代碼頁，格式為（1252 即 ANSI 的代碼頁是04e4），<keyname> 是你想要的鍵，如：CompanyName。為了構造這個查詢，你得用 sprintf 或者 CString::Format 來構造字符串：
\\StringFileInfo\\040904e4\\CompanyName
然後將這個字符串傳給 VerQueryValue。如果你對這些繁瑣的細節感到暈菜，不用擔心——很幸運，CModuleVersion::GetValue 對所有邋遢細節都進行了封裝，所以你只要像下面這樣寫即可：
CString s = ver.GetValue(_T("CompanyName"));
實現了 CModuleVersion，VersionDlg 就簡單多了。 它實際上就是一個對話框，這個對話框帶有一個編輯框，用於輸入模塊名稱，每當用戶在編輯框中敲入模塊名稱時，MFC 便調用 ON_EN_CHANGE 消息處理例程 CVersionDialog::OnChangedModule。OnChangedModule 例程通過 CModuleVersion 對象及其 GetFileVersionInfo 和 GetDllVersion 函數來獲得版本信息，然後將信息顯示在對話框的兩個靜態文本控件中。這個過程很簡單。
最後還有個技巧我得提一下。GetFileVersionInfo，VerQueryValue 以及其它有關文件版本函數在一個叫做 version.lib 的庫中，你必須將它鏈接到你程序中。從而避免鏈接時出現煩人的“undefined symbol”（未定義符號）錯誤，ModuleVer.h 使用了一個鮮為人知但特別有用的 #pragma comment 語法，即使你忘記在 Project|Settings 的 Link 屬性頁中添加 Input ==〉Libraries 也沒關系，#pragma comment 會告訴鏈接器與 version.lib 鏈接。
// 告訴鏈接器與 version.lib 進行鏈接
#pragma comment(linker,
"/defaultlib:version.lib")
現在，有人可能會問，為什麼這些東西如此重要？以及誰會需要這些東西呢？一般來說，如果你編寫的是顯示文件屬性之類的工具程序，那你只是需要獲取諸如 CompanyName 和 LegalCopyright 之類的變量。但你也許發現用 CModuleVersion 從自己的應用程序中吸取文件信息很有用，例如，為了在“關於”對話框和啟動屏幕中顯示版本信息。如果你使用 CModuleVersion，你只需修改資源文件中相應位置的版本信息即可，“關於”對話框和啟動屏幕會自動顯示當前最新版本信息。
版本信息另一個重要的用途是確定某個DLL是針對哪種語言編寫的，這樣你代碼能與之對應。隨著當今基於 Windows 的編程技術迅猛發展，DLLs 的新版本也隨之日新月異，你很快就會發現下面這樣的代碼越來越多：
if (version <= 470)
// do one thing
else if (version==471)
// do something else
else if (version==472)
// do a third thing
else
// scream
這是一件很郁悶的事情，我敢說這也是微軟的大佬們引入 DllGetVersion 來快速獲取版本號的一個原因，從而避免了面對讓人恐懼的 GetFileVersionInfo 函數，只用它來獲取語言 IDs 和代碼頁（僅在需要獲取諸如 CompanyName 這樣的信息時使用）。
comctl32.dll 的與眾不同也沒有什麼意外的，這個模塊版本問題已經程序員最大的禍害之一，我可憐的郵箱曾被讀者關於 comctl32.dll 這個模塊的問題撐爆，很多問題都是客戶下載了微軟最新版本的 comctl32.dll 到機器上之後，應用程序就無法運行了。我會在以後的文章中解釋 comctl32.dll 的版本問題，以及新的 toolbar 特性，如何解決 MFC 中 CToolBar 的 bug。現在，由於篇幅所限，我只能點到為止，目前 comctl32.dll 最新的版本為 6.00（隨 IE 一起發布）。
最後，感謝上帝，微軟已經出台關於可以隨你的應用程序一起分發 comctl32.dll！但不是單獨分發 comctl32.dll，而是可以隨你程序的更新包及其它文件一起分發。詳情參見：http://msdn.microsoft.com/developer/downloads/files/40comupd.htm，請在你的新版本出爐之前仔細閱讀。
本文配套源碼
