一直在鼓捣DLL,每天的工作都是调试一个一个的DLL,往DLL里面添加自己的代码,但是对于DLL一直不太了解啊!今天一查资料,才发现自己对于DLL编写的一些基本知识也不了解。要学习,这篇文章先总结DLL的导出函数的方法。
- 首先说一下如何建立一个普通的DLL工程!(以VS2008为例)
New Project --> Win32 标签 --> 填写工程名称 --> 点 OK,进入创建 Widzard --> Next 进入第二步 --> Application Type 中选择选择Dll 单选按钮。--> 在Additional Options中可以根据自己需求,确定是生成空工程,是否需要导出符号。
都不勾选,后期完全自己添加,看到的是一个DLL框架被创建,只有一个DLL函数,在DLL被加载时,由线程调用该函数,做初始化。如下图所示:
很简单,不多说了!
勾选不同的额外选项的情况,不再说明,自己可以尝试创建一下,看有什么区别。
- 导出模块中符号的三种方法
在说三种导出方式之前,先说一点关于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
_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;
}
_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
#ifdef __cplusplus
extern "C"{
#endif
的函数名称
#ifdef __cplusplus
};
#endif
#ifdef __cplusplus extern "C"{ #endif // 要导出的函数名称 #ifdef __cplusplus }; #endif
通过Link选项设置导出函数:
通过linker 选项来导出函数,通过这种方式可以将函数进行改名,即将在C++编译方式下导出的名称导出为一个指定的名称,而不用带有? @ 等字符的函数原名。
[cpp] view plain copy
#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;
}
#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
- EXPORTS
- DllCanUnloadNow @1 PRIVATE DATA
- DllWindowName = Name DATA
- DllGetClassObject @4 NONAME PRIVATE
- DllRegisterServer @7
- 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
用于指定一些节区的属性,比如设置节区为共享节区等。
- 基于MFC框架的DLL
可以很方便地到处全局变量,导出函数,导出类。有了MFC的支持,方便不少。这块已经不怎么用了吧,我平时很难涉及到,不想再总结了。有兴趣的可以找资料看一下。
ATL同样也有很多,基于ATL的COM模块,基本都是建立一个DLL模块。这块也不想多说了,无非是将ATL的框架,模板集成进去了,DLL作为容器而已。其实这个和DLL的知识没什么关系,完全不同的两部分内容,需要分开学。我觉得是酱紫的,哈哈哈哈!
没准以后工作中会遇到,遇到再说吧!^_^! 以够用为原则,学多了也记不住!
By AndyGuo @ 2015-08-11 午