MFC DLL 导出函数的定义方式

一直在鼓捣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++的变名方式。

通过导出符号导出：

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. return 0;
7. }

_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)

或者

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++编译方式下导出的名称导出为一个指定的名称，而不用带有? @ 等字符的函数原名。

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

#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 可选项，表示导出的为数据，而非代码。

示例：

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 午