MFC DLL 导出函数的定义方式

时间:2024-03-11 20:58:37

    一直在鼓捣DLL,每天的工作都是调试一个一个的DLL,往DLL里面添加自己的代码,但是对于DLL一直不太了解啊!今天一查资料,才发现自己对于DLL编写的一些基本知识也不了解。要学习,这篇文章先总结DLL的导出函数的方法。

        1. 首先说一下如何建立一个普通的DLL工程!(以VS2008为例)

        New Project  -->  Win32 标签 --> 填写工程名称 -->  点 OK,进入创建 Widzard  -->  Next 进入第二步 -->  Application Type 中选择选择Dll 单选按钮。--> 在Additional Options中可以根据自己需求,确定是生成空工程,是否需要导出符号。

        都不勾选,后期完全自己添加,看到的是一个DLL框架被创建,只有一个DLL函数,在DLL被加载时,由线程调用该函数,做初始化。如下图所示:

        

        很简单,不多说了!

        勾选不同的额外选项的情况,不再说明,自己可以尝试创建一下,看有什么区别。

        2. 导出模块中符号的三种方法

        在说三种导出方式之前,先说一点关于VS编译器的东西。VS编译器,默认创建出来的文件为 .cpp,即它默认的编译方式是C++。因此一般情况下,写函数时随时声明函数,随时使用,这是C++编译方式的好处,也是很多书上所提倡的变量使用方式,到使用时再定义,声明。而如果是 .c 文件,会被VS按照C的方式进行编译。会有什么区别呢?就是函数,变量名字的命名区别。编译器编译源文件后,会将源文件中用到的符号进行修改,C的方式是在符号(Symbols,函数名称,变量名称等)的前面加下划线,对于函数名称,后面会跟着@Num,Num为传参所占用的大小。而C++为了实现函数重载,对函数实行了变名机制(具体机制不再详解释了,可以搜索一下),比如函数名称,在变名中会体现函数源代码中名称,函数参数个数,参数类型,返回值等信息。因此用C方式编译的DLL库是无法使用C++方式编译的程序直接连接调用的;同理反过来亦如此。在编程中就有了extern "C" 的出现。如果C++项目中,要调用以C编译方式编译出来的DLL库,则需要将要导入的函数用extern "C" 的方式声明,以便这些函数在C++项目中被编译为C编译方式的函数名称,在C的lib库中可以找到相应的符号,链接。反过来,对于C++方式编译的DLL,则无法以静态链接的方式在C程序中调用;主要还是因为C编译方式编译出来的函数,无法链接到C++方式编译的DLL,及相应的lib上。  C++和C中的变名具体的内容,还和函数的调用方式相关__cdecl / __stdcall / _fastcall 几个方式的修饰符号也不相同。

        但是在这种情况下,还是可以通过动态引入的方式,使用GetProcAddress 函数根据函数名称获取函数地址,然后调用相应的函数。              

        在X64上又有不同的解释,X64编译的函数不变名。前面即没有下划线,函数名结尾处也没有参数空间大小,当然也不会类似C++的变名方式。

        通过导出符号导出

 

[cpp] view plain copy
 
 
print?
  1. _declspec(dllexport) int MyFunction(int a, char c, char* pInfo)  
  2. {  
  3.     char szInfo[MAX_PATH] = {};  
  4.     sprintf(szInfo, "a=%d, c=%c, Info: %s", a, c, pInfo);  
  5.     OutputDebugStringA(szInfo);  
  6.   
  7.     return 0;  
  8. }  
_declspec(dllexport) int MyFunction(int a, char c, char* pInfo)
{
	char szInfo[MAX_PATH] = {};
	sprintf(szInfo, "a=%d, c=%c, Info: %s", a, c, pInfo);
	OutputDebugStringA(szInfo);

	return 0;
}

        按照如上的方式,MyFunction 函数将被DLL导出,C/C++编译方式下,分别为导出为如下的函数(可以使用PE解析工具查看):

        如下为C++的编译方式导出的函数,可看到函数名称开始处有一个"?",结尾处为两个@@加上YAHHDPAD@Z ,他们共同表示了函数的参数,以及返回值。@@YA表示函数调用方式为 __cdecl,默认的调用方式。H表示返回值为Int,后面依次为参数列表的类型。(详细的内容可以搜索一下)

        

        如下为C编译方式导出的函数,仅有函数名称。

        

        如上所述,通常为了能够使得C++编译的模块能够在C和C++程序中都能调用,通常定义如下的宏,用于声明函数。一方面将函数导出,同时使得无论C++程序编译,还是C程序编译的DLL都按照C的编译方式导出函数。这样就可以满足C 和C++ 程序都可以调用。

        #define DLLEXPORT_API extern "C" _declspec(dllexport)

        或者

 

[cpp] view plain copy
 
 
print?
  1. #ifdef __cplusplus  
  2. extern "C"{  
  3. #endif  
  4. 的函数名称  
  5. #ifdef __cplusplus  
  6. };  
  7. #endif  
        #ifdef __cplusplus
        extern "C"{
        #endif
		// 要导出的函数名称
        #ifdef __cplusplus
        };
        #endif

        通过Link选项设置导出函数

        通过linker 选项来导出函数,通过这种方式可以将函数进行改名,即将在C++编译方式下导出的名称导出为一个指定的名称,而不用带有? @ 等字符的函数原名。

 

[cpp] view plain copy
 
 
print?
  1. #pragma comment(linker, "/EXPORT:MyFunction=?MyFunction@@YAHHDPAD@Z")  
  2.   
  3. int MyFunction(int a, char c, char* pInfo)  
  4. {  
  5.     char szInfo[MAX_PATH] = {};  
  6.     sprintf(szInfo, "Dll module: a=%d, c=%c, Info: %s\n", a, c, pInfo);  
  7.     OutputDebugStringA(szInfo);  
  8.   
  9.     return 0;  
  10. }  
#pragma comment(linker, "/EXPORT:MyFunction=?MyFunction@@YAHHDPAD@Z")

int MyFunction(int a, char c, char* pInfo)
{
	char szInfo[MAX_PATH] = {};
	sprintf(szInfo, "Dll module: a=%d, c=%c, Info: %s\n", a, c, pInfo);
	OutputDebugStringA(szInfo);

	return 0;
}

        如下图所示,上面代码中的函数,以C++的方式编译完成后,和之前的以C++方式导出函数的名称相同,我们使用 #pragma comment的形式,将该函数以函数原名称的形式导出。这样可以方便引用。

        

        通过.def 文件导出函数

 

        最正规的方法,还是通过定义.def 文件来导出函数。将要导出的函数,写到.def 文件 EXPORTS 字段下,即可将函数导出。在连接器阶段,使用/def 连接器选项调用.def 文件。def的内容对应于link 选项,.def 的语法如下所述:

        ×  语句,属性,关键字和指定的标识符区分大小写

        ×  使用一个,多个空格,制表符或换行符将语句关键字同其他参数分开和将语句分开。指定参数的冒号或等号前后可以有零个,多个空格,制表符或换行。

        ×  NAME 和 LIBRARY 语句,必须位于所有的其他的语句之前。

        ×  注释以 分号 开始

        EXPORTS 语句的语法如下:

                EXPORTS

                        entryname[=internalname] [@ordinal  [NONAME] ]  [PRIVATE]  [DATA]

                entryname 是要导出的函数名或变量名称。这一项必须有。

                =internalname 表示将一个名字为internalname的函数导出为entryname的函数。

                @ordinal  允许指定是序号导出函数,而不是以函数名导出。.lib 文件中包含了序号和函数之间的映射。

                NONAME为可选项,该关键字指明,只允许按照序号导出。

                PRIVATE 可选项,表示禁止将entryname放到LINK生成的导入库中。

                DATA 可选项,表示导出的为数据,而非代码。

        示例:

 

[cpp] view plain copy
 
 
print?
  1. EXPORTS      
  2.     DllCanUnloadNow         @1          PRIVATE     DATA      
  3.     DllWindowName  = Name                           DATA      
  4.     DllGetClassObject       @4  NONAME      PRIVATE      
  5.     DllRegisterServer       @7  
  6.     DllUnregisterServer  
EXPORTS    
	DllCanUnloadNow			@1			PRIVATE		DATA    
	DllWindowName  = Name							DATA    
	DllGetClassObject		@4	NONAME		PRIVATE    
	DllRegisterServer		@7
	DllUnregisterServer

        
        LIBRARY 选项

                LIBRARY  [library] [BASE=address]

                library 表示让link创建DLL,同时创建导入库。

                BASE=address 设置操作系统用来加载DLL的基址。

        SECTIOINS 选项

                SECTIONS

                        definitions

                用于指定一些节区的属性,比如设置节区为共享节区等。

        

        

        3. 基于MFC框架的DLL

        可以很方便地到处全局变量,导出函数,导出类。有了MFC的支持,方便不少。这块已经不怎么用了吧,我平时很难涉及到,不想再总结了。有兴趣的可以找资料看一下。

        ATL同样也有很多,基于ATL的COM模块,基本都是建立一个DLL模块。这块也不想多说了,无非是将ATL的框架,模板集成进去了,DLL作为容器而已。其实这个和DLL的知识没什么关系,完全不同的两部分内容,需要分开学。我觉得是酱紫的,哈哈哈哈!

        没准以后工作中会遇到,遇到再说吧!^_^! 以够用为原则,学多了也记不住!

 

        By  AndyGuo @ 2015-08-11 午