1   DLL的進(jìn)入/退出函數(shù)

1.1 DllMain簡(jiǎn)介

跟exe有個(gè)main或者WinMain入口函數(shù)一樣，DLL也有一個(gè)入口函數(shù)，就是DllMain。以“DllMain”為關(guān)鍵字，來(lái)看看MSDN幫助文檔怎么介紹這個(gè)函數(shù)的。

The DllMain function is an optional method of entry into a dynamic-link library (DLL)。（簡(jiǎn)要翻譯：對(duì)于動(dòng)態(tài)鏈接庫(kù)，DllMain是一個(gè)可選的入口函數(shù)。）這句話很重要，很多初學(xué)者可能都認(rèn)為一個(gè)動(dòng)態(tài)鏈接庫(kù)肯定要有DllMain函數(shù)。其實(shí)不然，像很多僅僅包含資源信息的DLL是沒有DllMain函數(shù)的。

1.2 何時(shí)調(diào)用DllMain

       系統(tǒng)是在什么時(shí)候調(diào)用DllMain函數(shù)的呢？靜態(tài)鏈接時(shí)，或動(dòng)態(tài)鏈接時(shí)調(diào)用LoadLibrary和FreeLibrary都會(huì)調(diào)用DllMain函數(shù)。DllMain的第三個(gè)參數(shù)fdwReason指明了系統(tǒng)調(diào)用Dll的原因，它可能是:

DLL_PROCESS_ATTACH、

DLL_PROCESS_DETACH、

DLL_THREAD_ATTACH

DLL_THREAD_DETACH。

以下從這四種情況來(lái)分析系統(tǒng)何時(shí)調(diào)用了DllMain。            

1.2.1 DLL_PROCESS_ATTACH

       大家都知道，一個(gè)程序要調(diào)用Dll里的函數(shù)，首先要先把DLL文件映射到進(jìn)程的地址空間。要把一個(gè)DLL文件映射到進(jìn)程的地址空間，有兩種方法：靜態(tài)鏈接和動(dòng)態(tài)鏈接的LoadLibrary或者LoadLibraryEx。

       當(dāng)一個(gè)DLL文件被映射到進(jìn)程的地址空間時(shí)，系統(tǒng)調(diào)用該DLL的DllMain函數(shù)，傳遞的fdwReason參數(shù)為DLL_PROCESS_ATTACH。這種調(diào)用只會(huì)發(fā)生在第一次映射時(shí)。如果同一個(gè)進(jìn)程后來(lái)為已經(jīng)映射進(jìn)來(lái)的DLL再次調(diào)用LoadLibrary或者LoadLibraryEx，操作系統(tǒng)只會(huì)增加DLL的使用次數(shù)，它不會(huì)再用DLL_PROCESS_ATTACH調(diào)用DLL的DllMain函數(shù)。不同進(jìn)程用LoadLibrary同一個(gè)DLL時(shí)，每個(gè)進(jìn)程的第一次映射都會(huì)用DLL_PROCESS_ATTACH調(diào)用DLL的DllMain函數(shù)。

       可參考DllMainTest的DLL_PROCESS_ATTACH_Test函數(shù)。

1.2.2 DLL_PROCESS_DETACH

       當(dāng)DLL被從進(jìn)程的地址空間解除映射時(shí)，系統(tǒng)調(diào)用了它的DllMain，傳遞的fdwReason值是DLL_PROCESS_DETACH。當(dāng)DLL處理該值時(shí)，它應(yīng)該執(zhí)行進(jìn)程相關(guān)的清理工作。

       那么什么時(shí)候DLL被從進(jìn)程的地址空間解除映射呢？?jī)煞N情況：

       ◆FreeLibrary解除DLL映射（有幾個(gè)LoadLibrary，就要有幾個(gè)FreeLibrary）

       ◆進(jìn)程結(jié)束而解除DLL映射，在進(jìn)程結(jié)束前還沒有解除DLL的映射，進(jìn)程結(jié)束后會(huì)解除DLL映射。（如果進(jìn)程的終結(jié)是因?yàn)檎{(diào)用了TerminateProcess，系統(tǒng)就不會(huì)用DLL_PROCESS_DETACH來(lái)調(diào)用DLL的DllMain函數(shù)。這就意味著DLL在進(jìn)程結(jié)束前沒有機(jī)會(huì)執(zhí)行任何清理工作。）

       注意：當(dāng)用DLL_PROCESS_ATTACH調(diào)用DLL的DllMain函數(shù)時(shí)，如果返回FALSE，說(shuō)明沒有初始化成功，系統(tǒng)仍會(huì)用DLL_PROCESS_DETACH調(diào)用DLL的DllMain函數(shù)。因此，必須確保清理那些沒有成功初始化的東西。

       可參考DllMainTest的DLL_PROCESS_DETACH_Test函數(shù)。

1.2.3 DLL_THREAD_ATTACH

       當(dāng)進(jìn)程創(chuàng)建一線程時(shí)，系統(tǒng)查看當(dāng)前映射到進(jìn)程地址空間中的所有DLL文件映像，并用值DLL_THREAD_ATTACH調(diào)用DLL的DllMain函數(shù)。

新創(chuàng)建的線程負(fù)責(zé)執(zhí)行這次的DLL的DllMain函數(shù)，只有當(dāng)所有的DLL都處理完這一通知后，系統(tǒng)才允許進(jìn)程開始執(zhí)行它的線程函數(shù)。

注意跟DLL_PROCESS_ATTACH的區(qū)別，我們?cè)谇懊嬲f(shuō)過，第n(n>=2)次以后地把DLL映像文件映射到進(jìn)程的地址空間時(shí)，是不再用DLL_PROCESS_ATTACH調(diào)用DllMain的。而DLL_THREAD_ATTACH不同，進(jìn)程中的每次建立線程，都會(huì)用值DLL_THREAD_ATTACH調(diào)用DllMain函數(shù)，哪怕是線程中建立線程也一樣。

1.2.4 DLL_THREAD_DETACH

       如果線程調(diào)用了ExitThread來(lái)結(jié)束線程（線程函數(shù)返回時(shí)，系統(tǒng)也會(huì)自動(dòng)調(diào)用ExitThread），系統(tǒng)查看當(dāng)前映射到進(jìn)程空間中的所有DLL文件映像，并用DLL_THREAD_DETACH來(lái)調(diào)用DllMain函數(shù)，通知所有的DLL去執(zhí)行線程級(jí)的清理工作。

       注意：如果線程的結(jié)束是因?yàn)橄到y(tǒng)中的一個(gè)線程調(diào)用了TerminateThread，系統(tǒng)就不會(huì)用值DLL_THREAD_DETACH來(lái)調(diào)用所有DLL的DllMain函數(shù)。

1.3 為DllMain換名

在早期的SDK版本中，DllMain是叫做DllEntryPoint。其實(shí)有一件鮮為人知的事：一個(gè)Dll的入口函數(shù)名是可以自己定義的。下面我將以VC++6.0為例來(lái)演示如何更改。首先要說(shuō)明一點(diǎn)，雖然DllMain可以換成其他函數(shù)名，但函數(shù)的參數(shù)和返回值必須和DllMain一樣。而且這個(gè)函數(shù)要為__stdcall類型（DllMain本身也是__stdcall類型）。

打開VC++菜單Project\Settings\Link tab\ Output in the Category box，如下圖，在Entry-point symbol中輸入要替換DllMain的函數(shù)名（當(dāng)然這個(gè)函數(shù)名是你程序中已經(jīng)實(shí)現(xiàn)的函數(shù)）。Entry-point symbol是干么的呢？可以以關(guān)鍵字“Entry-point symbol”搜索MSDN幫助文檔查看，搜索時(shí)，打鉤“僅搜索標(biāo)題”會(huì)更快定位。

         按OK后，如果馬上編譯的話會(huì)出現(xiàn)如下錯(cuò)誤：

LIBCMTD.lib(crt0.obj) : error LNK2001: unresolved external symbol _main

Debug/Dll.dll : fatal error LNK1120: 1 unresolved externals

打開VC++菜單Project\Settings\C/C++選項(xiàng)卡，如下圖，在Project Options：末尾的地方添加”/D”（圖中藍(lán)色高亮的地方），要注意位置，我試了，要把/D放到/GZ后面也會(huì)鏈接錯(cuò)誤，我也不懂為什么，^_^。按OK，再次編譯，成功。大家可以自己測(cè)試下到底有沒有更改成功，什么，如果測(cè)試？打出調(diào)式信息啊。

1.4 DisableThreadLibraryCalls

看幫助就知道它是干么用的：

The DisableThreadLibraryCalls function disables the DLL_THREAD_ATTACH and DLL_THREAD_DETACH notifications for the dynamic-link library (DLL) specified by hLibModule. This can reduce the size of the working code set for some applications.