分享

关于Dll导出函数名

 DavinTang 2011-03-04

使用Dependency看DLL的导出函数的名字,会发现有一些有意思的东西,这大多是和编译DLL时候指定DLL导出函数的导出符有关系。
//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
当你使用extern "C"的情况下:  
__stdcall会使导出函数名字前面加一个下划线,后面加一个@再加上参数的字节数,比如_Fun@4就是4个字节 
__fastcall类似__stdcall,不过前面没有下划线,_fastcall应该前面还有一个@,比如@LoadaDir@4
__cdecl则是前面仅仅有一个下划线
如果不用extern "C"话则使用C++命名机制,涉及到C++ Name Mangling,比较复杂,编译器之间也不太一样。
另外,__declspec(dllexport)仅会对__cdecl进行处理,去掉前面的下划线(对于一般全局函数来说缺省就是__cdecl),而对于其他两种不会处理。
//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
extern "C"的作用是(防止C++编译器的“名字破坏”特性),使编译器按照C的方式生成函数名,C的方式实际的函数名和你写的一样。如果没有这个,则按照 C++的方式生成函数名,这样实际的函数名(LoadLibrary方式GetProcAddress传入的函数名)和你写得函数名不一样,这样你用 LoadLibrary、GetProcAddress这种方式调用dll就不成功。  
但是用引入库(*.LIB)的方式调用,则编译器自动转换函数名,所以总是没有问题。  
//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
我们知道为了让DLL导出一些函数,需要在每一个将要被导出的函数前面添加标识符:_declspec(dllexport)。例如在DLL中可以导出这样的函数(方法)
#define DLL1_API _declspec(dllexport)
DLL1_API int Add(int a,int b)
{
return a+b;
}
现 在我们解决名字改编问题,C++编译器在生成DLL时,会对导出的函数进行名字改编,并且不同的编译器使用的改编规则不一样,因此改编后的名字也是不同 的。这样,如果利用不同编译器分别生成DLL和访问DLL的客户端程序,后者在访问该DLL的导出函数时就会出现问题。如上例中函数Add在C++编译器 改编后的名字是?Add@@YAHHH@Z。我们希望编译后的名字不发生改变,这里有几种方法。
第一种是定义导出函数时加上限定符:extern "C"
#define DLL1_API extern "C" _declspec(dllexport)
但extern "C"只解决了C和C++语方之间调用的问题,它只能用于导出全局函数这种情况而不能导出一个类的成员函数。另外如果导出函数的调用约定发生改变,即使使 用了extern "C",编译后的函数名还是会发生改变。比如我们加入_stdcall关键字说明调用约定为C调用约定(标准调用约定,也就是WINAPI调用约定)。
#define DLL1_API extern "C" _declspec(dllexport)
DLL1_API int _stdcall Add(int a,int b)
{
return a+b;
}
编译后函数名Add改编成了_Add@8
第二种方法是通过一个称为模块定义文件DEF来解决。
LIBRARY dllname
EXPORTS
Add
Subtract
LIBRARY 用来指定动态链接库内部名称。该名称与生成的动态链接库名一定在匹配,这句代码不是必须的。EXPORTS说明了DLL将要导出的函数,以及为这些导出函数指定的符号名。
通过第二种方法模块定义文件的方式DLL编译后导出函数名不会发生改变。
//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
传统的导出 DLL 函数的方法是使用模块定义文件 (.def),Visual C++ 提供了更简洁方便的方法,即 “__declspec(dllexport)” 关键字,例如:
__declspec(dllexport) int __stdcall MyExportFunction(int iTest);
但是通过查看工具我们可以发现,DLL 导出的函数名字实际上是 _MyExportFunction@4。还好,VC 提供了一个预处理指示符 “#pragma” 来指定链接选项,可以通过它达到我们的目的,如下:
#pragma comment(linker, "/EXPORT:MyExportFunction=_MyExportFunction@4")
这样再看,就会发现导出的函数名字已经成为了想要的MyExportFunction。
终于知道了,应该把函数前面的 __declspec() 修饰去掉,也就是说,只需要第二条 pragma 指令即可。而且还可以使如下形式:
#pragma comment(linker, "/EXPORT:MyExportFunction=_MyExportFunction@4,PRIVATE")
PRIVATE 的作用与其在 def 文件中的作用一样。




__cdecl和__stdcall都是函数调用规范(还有一个__fastcall),规定了参数出入栈的顺序和方法,
如果只用VC编程的话可以不用关心,但是要在C++和Pascal等其他语言通信的时候就要注意了,只有用相同的方法才能够调用成功.
另外,像printf这样接受可变个数参数的函数只有用cdecl才能够实现.  
 
__declspec 主要是用于说明DLL的引出函数的,在某些情况下用__declspec(dllexport)在DLL中生命引出函数,比用传统的DEF文件方便一些. 在普通程序中也可以用__declspec(dllimport)说明函数是位于另一个DLL中的导出函数.

例子不太好举啊,其实就是在函数声明的时候多加一个关键字,比如很多API函数就是象这样声明的:  
  int   WINAPI   MessageBoxA(HWND,LPCSTR,LPSTR,UINT);  
  而WINAPI实际上就是__stdcall.  
  大多数API都采用__stdcall调用规范,这是因为几乎所有的语言都支持__stdcall调用.相比之下,__cdecl只有在C语言中才能用. 但是__cdecl调用有一个特点,就是能够实现可变参数的函数调用,比如printf,这用__stdcall调用是不可能的.  
  __fastcall这种调用规范比较少见,但是在Borland   C++   Builder中比较多的采用了这种调用方式.  
  如果有共享代码的需要,比如写DLL,推荐的方法是用__stdcall调用,因为这样适用范围最广.如果是C++语言写的代码供Delphi这样的语言 调用就必须声明为__stdcall,因为Pascal不支持cdecl调用(或许Delphi的最新版本能够支持也说不定,这个我不太清楚).在其他一 些地方,比如写COM组件,几乎都用的是stdcall调用.在VC或Delphi或C++Builder里面都可以从项目设置中更改默认的函数调用规 范,当然你也可以在函数声明的时候加入__stdcall,__cdecl,__fastcall关键字来明确的指示本函数用哪种调用规范.  
  __declspec一般都是用来声明DLL中的导出函数.这个关键字也有一些其他的用法,不过非常罕见.
 
 

关于DLL的函数:  
   
  动态链接库中定义有两种函数:导出函数(export   function)和内部函数(internal   function)。  
  导出函数可以被其它模块调用,内部函数在定义它们的DLL程序内部使用。  
   
  输出函数的方法有以下几种:  
   
  1、传统的方法  
   
  在模块定义文件的EXPORT部分指定要输入的函数或者变量。语法格式如下:  
  entryname[=internalname]   [@ordinal[NONAME]]   [DATA]   [PRIVATE]  
   
  其中:  
   
  entryname是输出的函数或者数据被引用的名称;  
   
  internalname同entryname;  
   
  @ordinal表示在输出表中的顺序号(index);  
   
  NONAME仅仅在按顺序号输出时被使用(不使用entryname);  
   
  DATA表示输出的是数据项,使用DLL输出数据的程序必须声明该数据项为_declspec(dllimport)。  
   
  上述各项中,只有entryname项是必须的,其他可以省略。  
   
  对于“C”函数来说,entryname可以等同于函数名;但是对“C++”函数(成员函数、非成员函数)  
  来说,entryname是修饰名。可以从.map映像文件中得到要输出函数的修饰名,或者使用  
  DUMPBIN   /SYMBOLS得到,然后把它们写在.def文件的输出模块。DUMPBIN是VC提供的一个工具。  
   
  如果要输出一个“C++”类,则把要输出的数据和成员的修饰名都写入.def模块定义文件。  
   
  2、在命令行输出  
   
  对链接程序LINK指定/EXPORT命令行参数,输出有关函数。  
   
  3、使用MFC提供的修饰符号_declspec(dllexport)  
   
  在要输出的函数、类、数据的声明前加上_declspec(dllexport)的修饰符,表示输出。__declspec  
  (dllexport)在C调用约定、C编译情况下可以去掉输出函数名的下划线前缀。extern   "C"使得在C++中  
  使用C编译方式成为可能。在“C++”下定义“C”函数,需要加extern   “C”关键词。用extern   "C"来  
  指明该函数使用C编译方式。输出的“C”函数可以从“C”代码里调用。  
   
  例如,在一个C++文件中,有如下函数:  
  extern   "C"   {void   __declspec(dllexport)   __cdecl   Test(int   var);}  
  其输出函数名为:Test    
   
  MFC提供了一些宏,就有这样的作用。  
   
  AFX_CLASS_IMPORT:__declspec(dllexport)  
   
  AFX_API_IMPORT:__declspec(dllexport)  
   
  AFX_DATA_IMPORT:__declspec(dllexport)  
   
  AFX_CLASS_EXPORT:__declspec(dllexport)  
   
  AFX_API_EXPORT:__declspec(dllexport)  
   
  AFX_DATA_EXPORT:__declspec(dllexport)  
   
  AFX_EXT_CLASS:   #ifdef   _AFXEXT    
  AFX_CLASS_EXPORT  
  #else  
  AFX_CLASS_IMPORT  
   
  AFX_EXT_API:#ifdef   _AFXEXT  
  AFX_API_EXPORT  
  #else  
  AFX_API_IMPORT  
   
  AFX_EXT_DATA:#ifdef   _AFXEXT  
  AFX_DATA_EXPORT  
  #else  
  AFX_DATA_IMPORT  
   
  像AFX_EXT_CLASS这样的宏,如果用于DLL应用程序的实现中,则表示输出(因为_AFX_EXT被定义,通  
  常是在编译器的标识参数中指定该选项/D_AFX_EXT);如果用于使用DLL的应用程序中,则表示输入  
  (_AFX_EXT没有定义)。  
   
  要输出整个的类,对类使用_declspec(_dllexpot);要输出类的成员函数,则对该函数使用  
  _declspec(_dllexport)。如:  
   
  class   AFX_EXT_CLASS   CTextDoc    public   CDocument  
  
  …  
  
   
  extern   "C"   AFX_EXT_API   void   WINAPI   InitMYDLL();  
   
  这几种方法中,最好采用第三种,方便好用;其次是第一种,如果按顺序号输出,调用效率会高些;  
  最次是第二种。    
   
  六、模块定义文件(.DEF)  
   
  模块定义文件(.DEF)是一个或多个用于描述DLL属性的模块语句组成的文本文件,每个DEF文件至少必  
  须包含以下模块定义语句:  
   
   第一个语句必须是LIBRARY语句,指出DLL的名字;  
   EXPORTS语句列出被导出函数的名字;将要输出的函数修饰名罗列在EXPORTS之下,这个名字必须与  
  定义函数的名字完全一致,如此就得到一个没有任何修饰的函数名了。  
   可以使用DESCRIPTION语句描述DLL的用途(此句可选);  
   ";"对一行进行注释(可选)。  
   
  七、DLL程序和调用其输出函数的程序的关系  
   
  1、dll与进程、线程之间的关系  
   
  DLL模块被映射到调用它的进程的虚拟地址空间。  
  DLL使用的内存从调用进程的虚拟地址空间分配,只能被该进程的线程所访问。  
  DLL的句柄可以被调用进程使用;调用进程的句柄可以被DLL使用。  
  DLL使用调用进程的栈。  
   
  2、关于共享数据段  
   
  DLL定义的全局变量可以被调用进程访问;DLL可以访问调用进程的全局数据。使用同一DLL的每一个  
  进程都有自己的DLL全局变量实例。如果多个线程并发访问同一变量,则需要使用同步机制;对一个  
  DLL的变量,如果希望每个使用DLL的线程都有自己的值,则应该使用线程局部存储(TLS,Thread    
  Local   Strorage)。  
   
  在程序里加入预编译指令,或在开发环境的项目设置里也可以达到设置数据段属性的目的.必须给  
  这些变量赋初值,否则编译器会把没有赋初始值的变量放在一个叫未被初始化的数据段中。  
   
 
 

   
  extern   "C"   指示编译器用C语言方法给函数命名。  
   
  在制作DLL导出函数时由于C++存在函数重载,因此  
  __declspec(dllexport)   function(int,int)   在DLL会被decorate,例如被decorate成为   function_int_int,而且不同的编译器decorate的方法不同,造成了在用GetProcAddress取得function地址时的 不便,使用extern   "C"时,上述的decorate不会发生,因为C没有函数重载,但如此一来被extern"C"修饰的函数,就不具备重载能力,可以说extern   和   extern   "C"不是以回事。
 
__declspec(dllexport)   声明一个导出函数,是说这个函数要从本DLL导出。我要给别人用。一般用于dll中
__declspec(dllimport)   声明一个导入函数,是说这个函数是从别的DLL导入。我要用。一般用于使用某个dll的exe中 
_declspec(thread)可以降低程序员的负担,又能做到线程局部存储的要求。VC++允许一个变量或结构被声明为“具有线程局部性”。例如,下面的声明,如果放在一个DLL之中,将产生出一个全局变量,对每一个进程而言独一无二:  
  DWORD   gProgressCounter;  
  但是如果这样声明,它就是对每一个线程独一无二:  
  _declspec(thread)     DWORD   gProgressCounter; &


    本站是提供个人知识管理的网络存储空间,所有内容均由用户发布,不代表本站观点。请注意甄别内容中的联系方式、诱导购买等信息,谨防诈骗。如发现有害或侵权内容,请点击一键举报。
    转藏 分享 献花(0

    0条评论

    发表

    请遵守用户 评论公约

    类似文章 更多