Dll学习（一）--DllMain函数

1、首先看一下一个空的Dll。

      vc6.0环境，new-->project-->Win32 Dynamic-Link Library-->A simple Dll project

// SimpleDll.cpp : Defines the entry point for the DLL application. // #include "stdafx.h" BOOL APIENTRY DllMain( HANDLE hModule, DWORD ul_reason_for_call, LPVOID lpReserved ) { return TRUE; }

DllMain

 DllMain 函数是动态链接库 (DLL)的一个可选的入口点。

何时调用DllMain

当系统开始或终止进程或线程时，对于每一个加载的DLL，用进程的第一个线程调用入口点函数。

当用 LoadLibrary 和 FreeLibrary 函数加载或卸载DLL 时，系统也调用入口点函数。

 

BOOL WINAPI DllMain(
  HINSTANCE hinstDLL,  // handle to the DLL module
  DWORD fdwReason,     // reason for calling function
  LPVOID lpvReserved   // reserved
);

fdwReason指明了系统调用Dll的原因，以下从这四种情况来分析系统何时调用了DllMain。             
1.2.1 DLL_PROCESS_ATTACH
       大家都知道，一个程序要调用Dll里的函数，首先要先把DLL文件映射到进程的地址空间。

要把一个DLL文件映射到进程的地址空间，有两种方法：静态链接和动态链接的LoadLibrary。

       当一个DLL文件被映射到进程的地址空间时，系统调用该DLL的DllMain函数，传递的

fdwReason参数为DLL_PROCESS_ATTACH。这种调用只会发生在第一次映射时。

如果同一个进程后来为已经映射进来的DLL再次调用LoadLibrary或者LoadLibraryEx，

操作系统只会增加DLL的使用次数，它不会再用DLL_PROCESS_ATTACH调用DLL的DllMain函数。

不同进程用LoadLibrary同一个DLL时，每个进程的第一次映射都会用DLL_PROCESS_ATTACH

调用DLL的DllMain函数。

1.2.2 DLL_PROCESS_DETACH

       当DLL被从进程的地址空间解除映射时，系统调用了它的DllMain，传递的fdwReason值

是DLL_PROCESS_DETACH。当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函数。

因此，必须确保没有清理那些没有成功初始化的东西。

1.2.3 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函数，哪怕是线程中建立线程也一样。

1.2.4 DLL_THREAD_DETACH

       如果线程调用了ExitThread来结束线程（线程函数返回时，系统也会自动调用ExitThread），

系统查看当前映射到进程空间中的所有DLL文件映像，并用DLL_THREAD_DETACH来调用DllMain函数，

通知所有的DLL去执行线程级的清理工作。

       注意：如果线程的结束是因为系统中的一个线程调用了TerminateThread，系统就不会用值

DLL_THREAD_DETACH来调用所有DLL的DllMain函数。