DllMain

跟exe有个main或者WinMain入口函数一样，DLL也有一个入口函数，就是DllMain。以"DllMain"为关键字，来看看MSDN帮助文档怎么介绍这个函数的。

• 外文名称 DllMain
• 含义 就是DllMain

简介

　　The DllMain function is an optional method of entry into a dynamic-link library (DLL)。(简要翻译:对于动态链接库，DllMain是一个可选的入口函数。)这句话很重要，很多初学者可能都认为一个动态链接库肯定要有DllMain函数。其来自实不然，像很多仅仅包含资源360百科信息的DLL是没有DllMain函数的。

　　函数定义:

何时调介过末境本段生用

　　系统是在什么时候调用DllMain函数的呢?静态链接时，或动态链接时调用LoadLibrary和FreeLibrary都会调用DllMain函数府。DllMain的第二个参数fdwR光责内eason指明了系统调用D富众动路绿旧里河作ll的原因，它可能是::

　　DLL_PROCESS_ATTACH、

　　DLL_PR直代品稳密创OCESS_DETACH、

　　DLL_TH磁垂识复能苦举复皮张刘READ_ATTACH、

　　DLL_THREAD_DETACH。

读没将著自革　　以下从这四种情况来分析系统何时调用了DllMain。

进程映射

　　DLL_PROCESS_ATTACH

　　大家都知道，一个程序要调用Dll里的函数，首先要先把DLL文件映射到进乐略构到铁程的地址空间。要把一个DL过严著各坚露造曾续毛赶L文件映射到进程的地址空间，有两种方法:静态链接和动态链接的LoadLibrary或者LoadLibraryEx。

　　当一个DLL文件被映射到进程的地址空间时，加品蛋了式事系统调用该DLL的DllMain函数，传递的fdwReason参数为DLL_PROCESS_ATTACH，这种调用只会发生在第一次映射刑里英味车答前杆时。如果同一个进程后来确小再升激委端国士为已经映射进来的DLL再次调用LoadLibrary或者LoadLibrary乱息鲜同美富初牛济雨万Ex，操作系统只会增加DLL的使用次数，它不会再用DLL_PROCESS_ATTACH调用DLL的DllMain函数。不同进程用Loa视dLibrary同一治解史理开牛下房个DLL时，每个进程的第一次映射都会用DLL_PROCESS_ATTACH调用DLL的DllMain函数。

　　可参考DllMainTest的DLL_PROCESS_ATTACH_Test函数。

进程卸载

　　D六LL_PROCE松九冷赵春也试族足如SS_DETACH

　　当DLL被从进程的地址空间解除映射时，系统调用了它的DllMain，传递的fdwReason值是DLL_PROCESS_D才间重父陈三方队广ETACH。当DLL处理该值时，它应该执行进程相关的清理工作。

　　那么什么时候DLL被从进程的地址空间解除映射呢?两种情况:

　　◆FreeLibrary解除DLL映射(有几个LoadLibrary，就要有几个FreeLibrary)

　　◆进程结束而解除DLL映射，在进程结束前还没有解除DLL的映射，进程结束后会解除DLL映射。(如果进程的终结是因为调用了TerminateProcess，系统就不会用DLL_PROCESS_DETACH来调用DLL的DllMain函数。这就意味着DLL在进程结束前没有机会执行任何清理工作。)

　　注意:当用DLL_PROCESS_ATTACH调用DLL的DllMain函数时，如果返回FALSE，说明没有初始化成功，系统仍会用DLL_PROCESS_DETACH调用DLL的DllMain函数。因此，必须确保清理那些没有成功初始化的东西。

　　可参考DllMainTest的DLL_PROCESS_DETACH_Test函数。

线程映射

　　DLL_THREAD_ATTACH

　　当进程创建一线程时，系统查看当前映射到进程地址空间中的所有DLL文件映像，并用值DLL_THREAD_ATTACH调用DLL的DllMain函数。

　　新创建的线程负责执行这次的DLL的DllMain函数，只有当所有的DLL都处理完这一通知后，系统才允许进程开始执行它的线程函数。

　　注意跟DLL_PROCESS_ATTACH的区别，我们在前面说过，第n(n>=2)次以后地把DLL映像文件映射到进程的地址空间时，是不再用DLL_PROCESS_ATTACH调用DllMain的。而DLL_THREAD_ATTACH不同，进程中的每次建立线程，都会用值DLL_THREAD_ATTACH调用DllMain函数，哪怕是线程中建立线程也一样。

线程卸载

　　DLL_THREAD_DETACH

　　如果线程调用了ExitThread来结束线程(线程函数返回时，系统也会自动调用ExitThread)，系统查看当前映射到进程空间中的所有DLL文件映像，并用DLL_THREAD_DETACH来调用DllMain函数，通知所有的DLL去执行线程级的清理工作。

　　注意:如果线程的结束是因为系统中的一个线程调用了TerminateThread，系统就不会用值DLL_THREAD_DETACH来调用所有DLL的DllMain函数。

换名

　　在胜未简财殖征何并均早期的SDK版本中，DllMain是叫做DllEntryPoint。其实有一件鲜为人知的事:一个Dll的入口函数名是可以自己定义的。下面我将以VC++6.0为例来演示如何更改。首先要说明一点，虽然DllMain可以换成其他函数名，但函数的参数和返回值必须和DllMain一样。而且这来自个函数要为__stdcall类型(DllMain本身也是__stdcall类型)。

　　打开VC++菜单Project\Se议衣ttings\Link tab\ Output in the Catego360百科ry box，在Entry-point symbol中输入要替换DllMain的函数名(当然这个函数名是你程序中已经措完普续派毛商至走艺觉实现的函数)。Entry-point symbol是干么的呢?可跑门晶仍西立声时以以关键字"Entry-point symbol"搜索MSDN帮助文档查看，搜索时，打钩"仅搜索标题"会更快定位。

使用

　　DllMa举于场车二in函数是DLL模块的默认入口点。当Windows加载DLL模块时调用这一函数。系统首先调用全局对象的构造函数，然后调用全局函数DLLMain。DLLMain函数不仅在将DLL链接加载到进程时被调用，在D青LL模块与进程分离时(以及其它时候)也被调用。下面是一个框架DLLMain函数的例子。

　　如果我们在DllMain中写入专艺还顺下面的代码(在原来的gan紧差免主河加存星酸dll.c中添加下面的代码):

　　同时将dlltest\dlltest.c修改为:

　　我简单的测试一下输出结果为:

　　C:\gandll\dlltest>dlltest

　　hModule.10000000lpReserved.0012体FD30

　　Process attach.

　信情硫件各　Simple D际铁据面曲目扬LL teststart.

赵只静京　　Call DLLfunction:

　　Test DLL values:3

　　Call DLL functionend.

　　Simple DLL teste官移织参蒸王状机生绿nd.

　　hModule.1供0000000lpReserved.00000001

　　Process detach.

　　也就是说DLL加载和应用程序退出的使用都上假拉乐如盟成思会调用该函数(DllMain)的哦，是应用程序一上来就调用的，不是用到该函数时才调用的!