编译VC++类的动态链接库DLL 导出类及其中的函数

如果已经写好了一个C++的类，希望把它做成dll动态链接库，这里介绍一种简单的方法。

     1、制作dll
     利用VC6新建工程时选择win32 dynamic-Link Library，然后添加头文件和cpp文件。假设类名为exp，添加头文件exp.h，头文件中声明类的定义，添加exp.cpp，其中是成员函数的具体定义。与一般写类的定义不同，在exp.h中需要写成 
class __declspec(dllexport) exp
{
      ...
}
从而说明以后从dll要被导出的类是哪一个。这样编译完就会产生exp.dll和exp.lib两个文件。

      2、dll的调用
      当已经生成dll后，可以在其它程序中调用dll中的类和成员函数。方法如下：
      a)把exp.dll和exp.lib复制到调用程序的执行路径下，注意不是debug路径下。
      b)在project->setting->link里添加exp.lib
      c)把exp.h复制到调用程序的执行路径下，将__declspec(dllexport)改成__declspec(dllimport)
      这样在主程序中就可以使用exp.h中声明的类和它的成员函数了。

如何在VC中导出类，这是一个常有人问起的问题，下面我以一个简单的例子来说明这个问题： 

首先使用Wizard创建一个Win32 Dynamic-Link Library工程，然后定义一个简单的C++类CInDLL。由于该类会被工程之外的文件所引用，所以需要对这个类进行引出。因为只有引出后所生成的DLL中才带有供足够的信息以在连接和运行时被正确引入到进程空间中。有两种方法可以引出类，使用__declspec(dllexport)定义和使用定义文件。 

下面先讲使用__declspec(dllexport)的方法：将类定义改为：class __declspec(dllexport)  CInDLL 就可以了。（译者：你也许不相信会有这么简单，我也不相信。:-) 这样产生的工程在编译时是正确的但是在使用时会产生错误，因为你包含的头文件中也是使用__declspec(dllexport)，而使用这个DLL的工程中并没有引出这个类，而是需要引入这个类）在使用时需要将类定义改为class __declspec(dllimport) CInDLL就可以了。 

使用定义文件可以有效的避免这个问题，这种方法是利用宏定义在不同的地方产生不同的编译代码：在头文件中加入如下的代码：

#ifdef _CLASSINDLL 
   #define CLASSINDLL_CLASS_DECL     __declspec(dllexport) 
#else 
   #define CLASSINDLL_CLASS_DECL     __declspec(dllimport) 
#endif

#endif // ClassInDLL_H 
//将class __declspec(dllexport) CInDLL改为 
class CLASSINDLL_CLASS_DECL CInDLL 
{ 
CInDLL(); 
... 
}

在实现这个类的CPP文件的顶部加入#define _CLASSINDLL语句。  
#define _CLASSINDLL 
CInDLL::CInDLL() 
{ 
} 
... 
这样一来在使用这个类时就可以不做任何改动了。

（译者：这中方法在没有使用MFC时可以使用，如果你使用MFC生成MFC DLL那么只要做如下定义就可以了class AFX_EXT_CLASS yourClass）

 

关于DLL的函数

动态链接库中定义有两种函数：导出函数(export function)和内部函数(internal function)。导出函数可以被其它模块调用，内部函数在定义它们的DLL程序内部使用。

输出函数的方法有以下几种：

1、传统的方法

在模块定义文件的EXPORT部分指定要输入的函数或者变量。语法格式如下：

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

其中：

entryname是输出的函数或者数据被引用的名称；

internalname同entryname;

@ordinal表示在输出表中的顺序号(index)；

NONAME仅仅在按顺序号输出时被使用（不使用entryname）；

DATA表示输出的是数据项，使用DLL输出数据的程序必须声明该数据项为_declspec(DLLimport)。

上述各项中，只有entryname项是必须的，其他可以省略。

对于"C"函数来说，entryname可以等同于函数名；但是对"C++"函数（成员函数、非成员函数）来说，entryname是修饰名。可以从.map映像文件中得到要输出函数的修饰名，或者使用DUMPBIN /SYMBOLS得到，然后把它们写在.def文件的输出模块。DUMPBIN是VC提供的一个工具。

如果要输出一个"C++"类，则把要输出的数据和成员的修饰名都写入.def模块定义文件。

2、在命令行输出

对链接程序LINK指定/EXPORT命令行参数，输出有关函数。

3、使用MFC提供的修饰符号_declspec(DLLexport)

在要输出的函数、类、数据的声明前加上_declspec(DLLexport)的修饰符，表示输出。__declspec(DLLexport)在C调用约定、C编译情况下可以去掉输出函数名的下划线前缀。extern "C"使得在C++中使用C编译方式成为可能。在"C++"下定义"C"函数，

需要加extern "C"关键词。用extern "C"来指明该函数使用C编译方式。输出的"C"函数可以从"C"代码里调用。

例如，在一个C++文件中，有如下函数：

    extern "C" {void  __declspec(DLLexport) __cdecl Test(int var);} 

其输出函数名为：Test

MFC提供了一些宏，就有这样的作用。

AFX_CLASS_IMPORT：__declspec(DLLexport)   AFX_API_IMPORT：__declspec(DLLexport)   AFX_DATA_IMPORT：__declspec(DLLexport)   AFX_CLASS_EXPORT：__declspec(DLLexport)   AFX_API_EXPORT：__declspec(DLLexport)   AFX_DATA_EXPORT：__declspec(DLLexport)   AFX_EXT_CLASS： #ifdef _AFXEXT     AFX_CLASS_EXPORT         #else    AFX_CLASS_IMPORT   AFX_EXT_API：#ifdef _AFXEXT     AFX_API_EXPORT      #else     AFX_API_IMPORT   AFX_EXT_DATA：#ifdef _AFXEXT      AFX_DATA_EXPORT       #else      AFX_DATA_IMPORT 

像AFX_EXT_CLASS这样的宏，如果用于DLL应用程序的实现中，则表示输出（因为_AFX_EXT被定义，通常是在编译器的标识参数中指定该选项/D_AFX_EXT）；如果用于使用DLL的应用程序中，则表示输入（_AFX_EXT没有定义）。

要输出整个的类，对类使用_declspec(_DLLexpot)；要输出类的成员函数，则对该函数使用_declspec(_DLLexport)。如：

class AFX_EXT_CLASS CTextDoc : public CDocument {  … }  extern "C" AFX_EXT_API void WINAPI InitMYDLL(); 

这几种方法中，最好采用第三种，方便好用；其次是第一种，如果按顺序号输出，调用效率会高些；最次是第二种。