假设被调用的 DLL 存在一个导出函数,原型如下:

1
void printN(int);

三种方式从 DLL 导入导出函数

  • 生成 DLL 时使用模块定义 (.def) 文件
  • 在主应用程序的函数定义中使用关键字 __declspec(dllimport)__declspec(dllexport)
  • 利用#pragma comment(linker, "/export:[Exports Name]=[Mangling Name]"

def 编写规范:参考 模块定义 (.Def) 文件

基本规则:

  • LIBRARY 语句说明 .def ⽂件相应的 DLL;
  • EXPORTS 语句后列出要导出函数的名称。可以在 .def ⽂件中的导出函数名后加 @n,表 示要导出函数的序号为 n(在进⾏函数调⽤时,这个序号将发挥其作⽤);
  • .def ⽂件中的注释由每个注释⾏开始处的分号 (;) 指定,且注释不能与语句共享⼀⾏。

编写 dll 注意点

编写 dll 时,有个重要的问题需要解决,那就是函数重命名——Name-Mangling。解决方式有两种,一种是直接在代码里解决采用 extent”c”_declspec(dllexport)#pragma comment(linker, "/export:[Exports Name]=[Mangling Name]"),另一种是采用def 文件。

编写 dll 时,为什么有 extern “C”

原因:因为 C 和 C++ 的重命名规则是不一样的。这种重命名称为 “Name-Mangling”( 名字修饰或名字改编、标识符重命名,有些人翻译为“名字粉碎法”,这翻译显得有些莫名其妙)

据说,C++ 标准并没有规定 Name-Mangling 的方案,所以不同编译器使用的是不同的,例如:Borland C++ 跟 Mircrosoft C++ 就不同,而且可能不同版本的编译器他们的 Name-Mangling 规则也是不同的。这样的话,不同编译器编译出来的目标文件.obj 是不通用的,因为同一个函数,使用不同的 Name-Mangling 在 obj 文件中就会有不同的名字。如果 DLL 里的函数重命名规则跟 DLL 的使用者采用的重命名规则不一致,那就会找不到这个函数。

影响符号名的除了 C++ 和 C 的区别、编译器的区别之外,还要考虑调用约定导致的 Name Mangling。如 extern “c” __stdcall 的调用方式就会在原来函数名上加上写表示参数的符号,而 extern “c” __cdecl 则不会附加额外的符号。

dll 中的函数在被调用时是以函数名或函数编号的方式被索引的。这就意味着采用某编译器的 C++ 的 Name-Mangling 方式产生的 dll 文件可能不通用。因为它们的函数名重命名方式不同。为了使得 dll 可以通用些,很多时候都要使用 C 的 Name-Mangling 方式,即是对每一个导出函数声明为 extern “C”,而且采用_stdcall 调用约定,接着还需要对导出函数进行重命名,以便导出不加修饰的函数名。

注意到 extern “C” 的作用是为了解决函数符号名的问题,这对于动态链接库的制造者和动态链接库的使用者都需要遵守的规则。

动态链接库的显式装入就是通过 GetProcAddress 函数,依据动态链接库句柄和函数名,获取函数地址。因为 GetProcAddress 仅是操作系统相关,可能会操作各种各样的编译器产生的 dll,它的参数里的函数名是原原本本的函数名,没有任何修饰,所以一般情况下需要确保 dll 里的函数名是原始的函数名。分两步:
一,如果导出函数使用了 extern”C” _cdecl,那么就不需要再重命名了,这个时候 dll 里的名字就是原始名字;如果使用了extern”C” _stdcall,这时候 dll 中的函数名被修饰了,就需要重命名。
二、重命名的方式有两种,要么使用 *.def 文件,在文件外修正,要么使用#pragma,在代码里给函数别名。

_declspec(dllexport)_declspec(dllimport) 的作用

_declspec 还有另外的用途,这里只讨论跟 dll 相关的使用。正如括号里的关键字一样,导出和导入。_declspec(dllexport)用在 dll 上,用于说明这是导出的函数。而 _declspec(dllimport) 用在调用 dll 的程序中,用于说明这是从 dll 中导入的函数。

因为 dll 中必须说明函数要用于导出,所以 _declspec(dllexport) 很有必要。但是可以换一种方式,可以使用 def 文件来说明哪些函数用于导出,同时 def 文件里边还有函数的编号。

而使用 _declspec(dllimport) 却不是必须的,但是建议这么做。因为如果不用 _declspec(dllimport) 来说明该函数是从 dll 导入的,那么编译器就不知道这个函数到底在哪里,生成的 exe 里会有一个 call XX 的指令,这个 XX 是一个常数地址,XX 地址处是一个 jmp dword ptr[XXXX] 的指令,跳转到该函数的函数体处,显然这样就无缘无故多了一次中间的跳转。如果使用了 _declspec(dllimport) 来说明,那么就直接产生call dword ptr[XXX],这样就不会有多余的跳转了。

__stdcall带来的影响

这是一种函数的调用方式。默认情况下 VC 使用的是 __cdecl 的函数调用方式,如果产生的 dll 只会给 C/C++ 程序使用,那么就没必要定义为 __stdcall 调用方式,如果要给 Win32 汇编使用(或者其他的 stdcall 调用方式的程序),那么就可以使用stdcall。这个可能不是很重要,因为可以自己在调用函数的时候设置函数调用的规则。像 VC 就可以设置函数的调用方式,所以可以方便的使用 win32 汇编产生的 dll。不过__stdcall 这调用约定会Name-Mangling,所以我觉得用 VC 默认的调用约定简便些。但是,如果既要__stdcall 调用约定,又要函数名不给修饰,那可以使用 *.def 文件,或者在代码里 #pragma 的方式给函数提供别名(这种方式需要知道修饰后的函数名是什么)。

举例:

1
2
3
4
·extern “C” __declspec(dllexport) bool  __stdcall cswuyg();
·extern “C”__declspec(dllimport) bool __stdcall cswuyg();

·#pragma comment(linker, "/export:cswuyg=_cswuyg@0")

编写测试 dll 代码

项目结构:

cpp 源代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
 #include <iostream>
using namespace std;

extern "C" {
_declspec(dllexport) void printN(int n)
{
//printf("%d\n", n);
cout << n << endl;
}
}

void printM(int m)
{
cout << m << endl;
}

#pragma comment(linker, "/export:getNresult=?getNresult@@YAHXZ")
int getNresult()
{
//printf("%d\n", n);
return 123;
}

def 代码:

1
2
3
LIBRARY DLLTEST
EXPORTS
printM

项目属性中将配置类型改为 dll:

模块定义文件改为 dlltest.def:

编译之后,使用 CFF Explorer 查看导出函数:

其中 printN 函数用 extern "C" _declspec(dllexport) 的方式导出,避免了函数名粉碎;
printM函数用 def 的形式导出,也避免了函数名粉碎;
getNresult函数用 #pragma comment(linker, "/export:getNresult=?getNresult@@YAHXZ") 的形式避免了函数名粉碎,但是需要知道粉碎后的原始函数符号;

这里涉及一个问题,原始函数符号怎么找到的,方法是先用 _declspec(dllexport) 方式导出,然后编译后利用 CFF 即可看到原始函数符号。

编译 dll 后会产生一个 dll 文件和一个 lib 文件,如果是运行时动态调用的方式只使用 dll 文件就行,如果要在编译时以库的形式提供给 exe 调用则需要 lib 文件。

编写 exe 调用 dll

项目结构:

cpp 源码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
#include <iostream>
using namespace std;
#pragma comment(lib, "C:\\project\\dlltest\\Debug\\dlltest.lib")

extern "C" __declspec(dllimport) void printN(int);
int getNresult();
void printM(int);
int main()
{
printN(123);
printM(12);
cout << getNresult() << endl;
return 0;
}

#pragma 中更改为自己的 lib 路径,printNextern "C" __declspec(dllimport) 形式导入,getNresultprintM 是 c++ 格式的,应该使用 __declspec(dllimport) 导入,不过导入函数的情况下可以省略不写,引用外部变量则不能省略。

执行结果:




root@kali ~# cat 重要声明
本博客所有原创文章,作者皆保留权利。> 转载必须包含本声明,保持文本完整,并以超链接形式注明出处【[Techliu](https://scriptboy.cn)】。查看和编写文> 章评论都需翻墙,为了更方便地获取文章信息,可订阅[RSS](https://feeds2.feedburner.com/techliu),如果您还没有 一款喜爱的阅读器,不妨试试[Inoreader.](https://www.inoreader.com)。
r oot@kali ~# Thankyou!

⬆︎TOP