dllMain函数的作用

男娘i 2022-05-12 14:06 265阅读 0赞

## 1 DLLMain()函数的功能 ##

## Windows在加载DLL的时候，需要一个入口函数，就如同控制台或DOS程序需要main函数、Win32程序需要WinMain函数一样。根据编写规范，Windows必须查找并执行DLL里的DllMain函数作为加载DLL的依据，它使得DLL得以保留在内存里。这个函数并不属于导出函数，而是DLL的内部函数。这意味着不能直接在应用工程中引用DllMain函数，DllMain是自动被调用的。 ##

## 注：一些例子中，DLL并没有提供DllMain函数，应用工程也能成功引用DLL，这是因为Windows在找不到DllMain的时候，系统会从其它运行库中引入一个不做任何操作的缺省DllMain函数版本，并不意味着DLL可以放弃DllMain函数。 ##

2 使用示例

# #

我们来看一个DllMain函数的例子

<table> 
 <tbody> 
  <tr> 
   <td> <p>BOOL APIENTRY DllMain( HANDLE hModule, DWORD ul_reason_for_call, LPVOID lpReserved)<br> { <br> 　switch (ul_reason_for_call)<br> 　{ <br> 　　case DLL_PROCESS_ATTACH:<br> 　　　printf("\nprocess attach of dll");<br> 　　　break;<br> 　　case DLL_THREAD_ATTACH:<br> 　　　printf("\nthread attach of dll");<br> 　　　break;<br> 　　case DLL_THREAD_DETACH:<br> 　　　printf("\nthread detach of dll");<br> 　　　break;<br> 　　case DLL_PROCESS_DETACH:<br> 　　　printf("\nprocess detach of dll");<br> 　　　break;<br> 　}<br> 　return TRUE;<br> }</p> </td> 
  </tr> 
 </tbody> 
</table>

3  参数含义

DllMain的函数头定义为：

**BOOL APIENTRY DllMain( HANDLE hModule, WORD ul\_reason\_for\_call, LPVOID lpReserved )**

其中，**APIENTRY**被定义为\_\_stdcall，它意味着这个函数以标准Pascal的方式进行调用，也就是WINAPI方式；

函数**参数hModule**是进程中的每个DLL模块被全局唯一的32字节的HINSTANCE句柄标识**（句柄代表了DLL模块在进程虚拟空间中的起始地址，**只有在特定的进程内部有效**）**。在Win32中，HINSTANCE和HMODULE的值是相同的，这两种类型可以替换使用。

**参数ul\_reason\_for\_call**指明了被调用的原因。共有4种，即PROCESS\_ATTACH、PROCESS\_DETACH、THREAD\_ATTACH和THREAD\_DETACH，以switch语句列出。

**lpReserved** 表示一个保留参数，目前已经很少使用

4 调用方式

DllMain函数在以下几种情况被调用：

1） DLL被加载

一个程序要调用Dll里的函数，首先要先把DLL文件映射到进程的地址空间。要把一个DLL文件映射到进程的地址空间，有两种方法：静态链接和动态链接的LoadLibrary或者LoadLibraryEx。

当一个DLL文件被映射到进程的地址空间时，系统调用该DLL的DllMain函数，传递的fdwReason参数为DLL\_PROCESS\_ATTACH。这种调用只会发生在第一次映射时。如果同一个进程后来为已经映射进来的DLL再次调用LoadLibrary或者LoadLibraryEx，操作系统不会再用DLL\_PROCESS\_ATTACH调用DLL的DllMain函数，而是增加DLL的使用次数。不同进程用LoadLibrary同一个DLL时，每个进程的第一次映射都会用DLL\_PROCESS\_ATTACH调用DLL的DllMain函数。

2） DLL被卸载

当DLL被从进程的地址空间解除映射时，系统调用了它的DllMain，传递的fdwReason值是DLL\_PROCESS\_DETACH。当**DLL处理该值时，它应该执行进程相关的清理工作**。DLL被从进程的地址空间解除映射的情况有两种：

① FreeLibrary（）被调用。（有几个LoadLibrary，就要有几个FreeLibrary）

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

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

3） 单个线程启动

当进程创建一线程时，系统查看当前映射到进程地址空间中的所有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函数，哪怕是线程中建立线程也一样。

4） 单个线程终止

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

注意：如果线程的结束是因为系统中的一个线程调用了**TerminateThread（）**，系统就不会用值DLL\_THREAD\_DETACH来调用所有DLL的DllMain函数。

## 5 注意事项 ##

## \_\_stdcall约定 ##

为了使VC++编写的DLL能被其他语言编写的程序调用， 函数的调用方式应显式声明为\_\_stdcall方式，因为在C/C++中，缺省的调用方式为\_\_cdecl。

\_\_stdcall方式与\_\_cdecl调用方式的区别在于会将函数名处理成不同的符号。具体如下：

\_\_stdcall调用约定在输出函数名前面加下划线，后面加“@”符号和参数的字节数，形如\_functionname@number；

\_\_cdecl调用约定仅在输出函数名前面加下划线，形如\_functionname。

Windows编程中常见的几种函数类型声明宏都是与\_\_stdcall和\_\_cdecl有关的（节选自windef.h）：

**\#define CALLBACK \_\_stdcall //这就是传说中的回调函数  
\#define WINAPI \_\_stdcall //这就是传说中的WINAPI  
\#define WINAPIV \_\_cdecl  
\#define APIENTRY WINAPI //DllMain的入口就在这里  
\#define APIPRIVATE \_\_stdcall  
\#define PASCAL \_\_stdcall**

在lib.h中，应这样声明add函数：

<table> 
 <tbody> 
  <tr> 
   <td> <p>int __stdcall add(int x, int y);</p> </td> 
  </tr> 
 </tbody> 
</table>

在应用工程中函数指针类型应定义为：

<table> 
 <tbody> 
  <tr> 
   <td> <p>typedef int(__stdcall *lpAddFun)(int, int);</p> </td> 
  </tr> 
 </tbody> 
</table>

执行下列代码：

<table> 
 <tbody> 
  <tr> 
   <td> <p>hDll = LoadLibrary("text.dll");<br> if (hDll != NULL)<br> { <br> 　addFun = (lpAddFun)GetProcAddress(hDll, MAKEINTRESOURCE(1));<br> 　//MAKEINTRESOURCE直接使用导出文件中的序号<br> 　if (addFun != NULL)<br> 　{ <br> 　　int result = addFun(2, 3);<br> 　　printf("\ncall add in dll:%d", result);<br> 　}<br> 　FreeLibrary(hDll);<br> }</p> </td> 
  </tr> 
 </tbody> 
</table>

我们看到输出顺序为：

<table> 
 <tbody> 
  <tr> 
   <td> <p>process attach of dll<br> call add in dll:5<br> process detach of dll</p> </td> 
  </tr> 
 </tbody> 
</table>

这一输出顺序验证了DllMain被调用的时机。  
  
　　代码中的GetProcAddress ( hDll, MAKEINTRESOURCE ( 1 ) )值得留意，它直接通过.def文件中为add函数指定的顺序号访问add函数，具体体现在MAKEINTRESOURCE ( 1 )，MAKEINTRESOURCE是一个通过序号获取函数名的宏，定义为（节选自winuser.h）：

<table> 
 <tbody> 
  <tr> 
   <td> <p>#define MAKEINTRESOURCEA(i) (LPSTR)((DWORD)((WORD)(i)))<br> #define MAKEINTRESOURCEW(i) (LPWSTR)((DWORD)((WORD)(i)))<br> #ifdef UNICODE<br> #define MAKEINTRESOURCE MAKEINTRESOURCEW<br> #else<br> #define MAKEINTRESOURCE MAKEINTRESOURCEA</p> </td> 
  </tr> 
 </tbody> 
</table>