在VC中创建并调用DLL

转自：http://express.ruanko.com/ruanko-express_45/technologyexchange6.html

一、DLL简介

1.什么是DLL？

动态链接库英文为DLL，是Dynamic Link Library 的缩写形式，DLL是一个包含可由多个程序同时使用的代码和数据的库，DLL不是可执行文件。动态链接提供了一种方法，使进程可以调用不属于其可执行代码的函数。函数的可执行代码位于一个 DLL 中，该 DLL 包含一个或多个已被编译、链接并与使用它们的进程分开存储的函数。DLL 还有助于共享数据和资源。多个应用程序可同时访问内存中单个DLL 副本的内容。DLL 是一个包含可由多个程序同时使用的代码和数据的库。

动态链接库可以更为容易地将更新应用于各个模块，而不会影响该程序的其他部分。例如，您有一个大型网络游戏，如果把整个数百MB甚至数GB的游戏的代码都 放在一个应用程序里，日后的修改工作将会十分费时，而如果把不同功能的代码分别放在数个动态链接库（DLL）中，您无需重新生成或安装整个程序就可以应用更新。

2.DLL的优点

1、扩展了应用程序的特性；

2、可以用许多种编程语言来编写；

3、简化了软件项目的管理；

4、有助于节省内存；

5、有助于资源共享；

6、有助于应用程序的本地化；

7、有助于解决平台差异；

8、可以用于一些特殊的目的。windows使得某些特性只能为DLL所用。

二、DLL创建

添加一个解决方案，然后在解决方案下面添加一个新项目，选择项目类型为“Win32项目”，并输入项目名称，并点击确定，如图1所示：

图1

在“Win32 应用程序向导”中，选择应用程序类型为“DLL”，并在附加选项中，勾选“导出符号”，并点击“完成”按钮，如图2所示：

图2

点击完成后，系统会创建相应的项目文件，如图3所示：

图3

MyDLL.h中的相应代码如下所示：

// 下列ifdef 块是创建使从DLL 导出更简单的
// 宏的标准方法。此DLL 中的所有文件都是用命令行上定义的MYDLL_EXPORTS
// 符号编译的。在使用此DLL 的
// 任何其他项目上不应定义此符号。这样，源文件中包含此文件的任何其他项目都会将
// MYDLL_API 函数视为是从DLL 导入的，而此DLL 则将用此宏定义的
// 符号视为是被导出的。
#ifdef MYDLL_EXPORTS
#define MYDLL_API __declspec(dllexport)
#else
#define MYDLL_API __declspec(dllimport)
#endif

// 此类是从MyDLL.dll 导出的
class MYDLL_API CMyDLL {
public:
	CMyDLL(void);
	// TODO: 在此添加您的方法。
};

extern MYDLL_API int nMyDLL;

MYDLL_API int fnMyDLL(void);

MyDLL.cpp文件内容
// MyDLL.cpp : 定义DLL 应用程序的入口点。
//

#include "stdafx.h"
#include "MyDLL.h"

#ifdef _MANAGED
#pragma managed(push, off)
#endif
//DLL被调用时的入口
BOOL APIENTRY DllMain( HMODULE hModule,
                       DWORD  ul_reason_for_call,
                       LPVOID lpReserved
					 )
{
     //判断被调用的方式，根据实际被调用的方式，可以在下列判断中来做相应的操作，比如初始化工作
	switch (ul_reason_for_call)
	{
	case DLL_PROCESS_ATTACH:
	case DLL_THREAD_ATTACH:
	case DLL_THREAD_DETACH:
	case DLL_PROCESS_DETACH:
		break;
	}
    return TRUE;
}

#ifdef _MANAGED
#pragma managed(pop)
#endif

// 这是导出变量的一个示例
MYDLL_API int nMyDLL=0;

// 这是导出函数的一个示例。
MYDLL_API int fnMyDLL(void)
{
	return 42;
}

// 这是已导出类的构造函数。
// 有关类定义的信息，请参阅MyDLL.h
CMyDLL::CMyDLL()
{
	return;
}

编译并生成DLL项目，如下图所示：

图4

在使用的过程中，要用到生成的dll、lib文件。但两者有什么区别和联系呢？

Lib（引入库文件）是编译时需要的，dll是运行时需要的。引入库文件包含被DLL导出的函数的名称和位置，DLL包含实际的函数和数据，应用程序使用LIB文件链接到所需要使用的DLL文件，库中的函数和数据并 不复制到可执行文件中，因此在应用程序的可执行文件中，存放的不是被调用的函数代码，而是DLL中所要调用的函数的内存地址，这样当一个或多个应用程序运 行是再把程序代码和被调用的函数代码链接起来，从而节省了内存资源。

开发和使用dll需注意三种文件：

1）dll头文件

它是指dll中说明输出的类或符号原型或数据结构的.h文件。当其它应用程序调用dll时，需要将该文件包含入应用程序的源文件中。

2）dll的引入库文件(.lib)

它是dll在编译、链接成功后生成的文件。主要作用是当其它应用程序调用dll时，需要将该文件引入应用程序。否则，dll无法引入。

3）dll文件(.dll)

它是应用程序调用dll运行时，真正的可执行文件。dll应用在编译、链接成功后，.dll文件即存在。开发成功后的应用程序在发布时，只需要有.exe文件和.dll文件，不必有.lib文件和dll头文件。

从使用的角度上来看，如何静态调用，则要用到lib文件，而动态调用则不用，只需要DLL文件就够了。

三、DLL调用

DLL的调用分为动态和静态两种：动态调用和静态调用。动态调用方式的特点是完全由编程者用 API 函数加载和卸载 DLL，程序员可以决定 DLL 文件何时加载或不加载，显式链接在运行时决定加载哪个 DLL 文件。

动态调用，即显式调用方式，是由编程者用API函数加载和卸载DLL来达到调用DLL的目的，比较复杂，但能更加有效地使用内存，是编制大型应用程序时的重要方式。在Windows系统中，与动态库调用有关的函数包括：

①LoadLibrary（或MFC 的AfxLoadLibrary），装载动态库。

②GetProcAddress，获取要引入的函数，将符号名或标识号转换为DLL内部地址。

③FreeLibrary（或MFC的AfxFreeLibrary），释放动态链接库。

静态调用，也称为隐式调用，由编译系统完成对DLL的加载和应用程序结束时DLL卸载的编码（Windows系统负责对DLL调用次数的计数），调用方式简单，能够满足通常的要求。通常采用的调用方式是把产生动态连接库时产生的.LIB文件加入到应用程序的工程中，想使用DLL中的函数时，只须在源文件中声明一下。

LIB文件包含了每一个DLL导出函数的符号名和可选择的标识号以及DLL文件名，不含有实际的代码。Lib文件包含的信息进入到生成的应用程序中，被调用的DLL文件会在应用程序加载时同时加载在到内存中。

静态调用方式的特点是由编译系统完成对DLL的加载和应用程序结束时 DLL 的卸载。当调用某DLL的应用程序结束时，若系统中还有其它程序使用该 DLL，则Windows对DLL的应用记录减1，直到所有使用该DLL的程序都结束时才释放它。静态调用方式简单实用，但不如动态调用方式灵活。

1.静态调用

那么接下来就是，创建一个MFC项目来调用刚刚生成的DLL里面封装的函数、类。

首先在同一个解决方案下面创建一个MFC应用程序，如图5 所示：

图5

选择基于对话框的应用程序，然后选择“完成”按钮，如下图所示：

图6

右键点击MFC应用程序的属性，然后在左侧树形列表中，选择“C/C++”，在“附加包含目录”里面，添加“..\MyDLL”（为什么加上这个？因为我们在测试程序中，会调用DLL里面包含可调用函数的定义头文件，而我们不将这个文件拷发到自己的项目下面，而直接将DLL的目录的相对地址，添加到附加包含目录里面。）

图7

另外，静态调用会根据DLL的Lib文件来获取相应的封装函数，因此，我们在“链接器”->“输入”->“附加依赖项”里面，添加MyDLL.lib所在的相对地址。

图8

接着，在T_MyDLLDlg.cpp文件中，添加引用DLL的头文件“MyDLL.h”

// T_MyDLLDlg.cpp : 实现文件
#include "stdafx.h"
#include "T_MyDLL.h"
#include "T_MyDLLDlg.h"

#include "MyDLL.h"				//添加头文件

在初始化函数中，开始调用DLL里面的封装函数和类，在那里，我们可以打一下断点，然后去看看n的值是否发生了变化，我们定义了一个CMyDLL的对象，是否存在内容。

BOOL CT_MyDLLDlg::OnInitDialog()
{
	CDialog::OnInitDialog();

	// ....

	//调用DLL里面的方法和类
	int n = fnMyDLL();

	CMyDLL myDll;

	return TRUE;  // 除非将焦点设置到控件，否则返回TRUE
}

经过这里，我们就可以实现了一个简单的DLL的创建以及调用，虽然在DLL里面，封装的是系统自动创建的一些函数和代码，但我们也可以依葫芦画瓢添加自己的函数。

比如：在CMyDLL类里面添加一个带参数的Add函数，实现简单的相加功能，也可以像fnMyDLL一样，添加一个成员函数，来实现其他功能（参见例子：DLLDemo解决方案下面T_MyDLL例子）。

2.动态调用

动态调用要知道DLL的文件路径，并且知道接口函数的类型及参数，并不需要依赖到.h文件、lib文件等内容。

但是，要动态调用DLL里面的函数的话，那么在该函数的前面必须要添加一个extern "C"(声明为C编译、连接方式的外部函数)，不然动态调用会找不到这个函数地址的。

如下，在MyDLL.h中添加下列代码：

extern "C" MYDLL_API int Add(int a, int b);

在MyDLL.cpp中添加下列代码：

MYDLL_API int Add(int a, int b)
{
	return a + b;
}

创建一个MFC对话框应用程序，然后在初始化函数中加入下列代码：

{
	CDialog::OnInitDialog();

	// ....省略其他代码
//加载MyDLL.dll
	HINSTANCE hDllInst = AfxLoadLibrary(_T("MyDLL.dll"));
//判断是否加载成功
	if(hDllInst)
	{
     //根据DLL里面的封装函数来定义函数指定
		typedef int(*pAdd)(int ,int);

		pAdd myAdd;
         //根据函数名来从已加载的DLL中获取函数地址并赋值
		myAdd = (pAdd)GetProcAddress(hDllInst, "Add");
         //判断是否获取成功
		if(myAdd != NULL)
		{
              //调用该函数
			int a = myAdd(10, 20);
			CString str;
			str.Format(_T("%d"), a);
			TRACE(str);
		}
         //释放加载的DLL
		AfxFreeLibrary(hDllInst);
	}

	return TRUE;
}

（参见例子：DLLDemo解决方案下面D_MyDLL例子）

四、DLL深入应用

1.DEF文件

.def是指模块定义文件。它被用于导出一个DLL的函数，和__declspec(dllexport)很相似。模块定义文件的作用即是，告知编译器不要以microsoft编译器的方式处理函数名，而以指定的某方式编译导出函数（比如有函数func，让编译器处理 后函数名仍为func）。这样，就可以避免由于microsoft VC++编译器的独特处理方式而引起的链接错误。

具体的一些说明可参见：http://msdn.microsoft.com/zh-cn/28d6s79h%28VS.90%29.aspx

下面将，介绍在MyDLL项目中添加一个Def文件，并添加相应的内容：

图9

图10

双击MyDLL文件，并在其中添加下列代码：

LIBRARY	"MyDLL"

EXPORTS
    fnMyDLL				@1
    MyADD = Add				@2

在这里EXPORTS下面的是导出函数的列表，@1代表的是一个导出的顺序编号。而MyADD=Add这句话的意思是，Add函数可允许被外部调用的时候用到MyADD这个名字。目前实验，只针对动态调用这种方式，也就是说在动态调用的时候，通过函数名来获取函数地址的时候，函数名可使用MyADD这个名字，那么在DLLDemo解决方案下面D_MyDLL例子里面，可以这样子用：

myAdd = (pAdd)GetProcAddress(hDllInst, "MyADD");

2.共享内存

不同的应用程序都拥有各自的内存区域，那么两个进程间如何共同访问同一个内存区域呢？DLL是实现这种方式之一。在DLL可以开辟一块共享内存，能够被调用DLL的不同进程之间进行数据共享，可以达到各种各样的应用。那么下面将讲解如何在DLL中进行操作共享内存区域。

首先，创建一个动态链接库项目ShareDLL，然后删除掉系统自动创建的函数和变量。然后在ShareDLL.cpp中添加下列代码：

#pragma data_seg(".shared")
	TCHAR theBuffer[1024] = {0};
#pragma data_seg()

然后在ShareDLL.h中添加两个函数：

extern "C" SHAREDLL_API int SetBuffer(TCHAR * IntoDLL);
extern "C" SHAREDLL_API int GetBuffer(TCHAR * IntoDLL);

在ShareDLL.cpp中添加操作代码：

SHAREDLL_API int SetBuffer(TCHAR * IntoDLL)
{
	wcscpy(theBuffer, IntoDLL);
	return 0;
}

SHAREDLL_API int GetBuffer(TCHAR * FromDLL)
{
	wcscpy(FromDLL, theBuffer);
	return 0;
}

然后添加一个模块定义文件ShareDLL.def，在其中添加如下代码：

LIBRARY	"ShareDLL"

SECTIONS
	.shared   READ WRITE SHARED

EXPORTS
	SetBuffer   @1
	GetBuffer	@2

注意：.这里的“.share”与CPP文件前面定义的“#pragma data_seg(".shared")”名字是相同的 ，表明在DLL中创建的共享内存名，是这个DLL自己创建的独有的。

创建两个测试的MFC对话框应用程序，界面如下图所示：

图11

两个按钮，分别调用的是DLL中的两个函数，然后分别在测试程序的设置按钮里面，设置不同的内容，然后再进行查看，你会发现，当TestShare1中进行设置的内容，可以在TestShare2中进行获取并显示。