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