DLL的Export和Import及extern "C"

今天使用Unrar.dll，在调用RARProcessFileW时，VS总是提示“error LNK2001: 无法解析的外部符号”。

Unrar.dll中是使用 extern "C" 对外输出函数，测试发现，其他函数可以正常调用，只有RARProcessFileW有此错误。

最后检查发现在.def文件中没有导出这个文件。

EXPORTS
RAROpenArchive
RAROpenArchiveEx
RARCloseArchive
RARReadHeader
RARReadHeaderEx
RARProcessFile
RARProcessFileW
RARSetCallback
RARSetChangeVolProc
RARSetProcessDataProc
RARSetPassword
RARGetDllVersion

DLL的export是指将DLL中的函数和数据输出到其它程式中，以供其使用。

DLL的import是指使用DLL的程式引入DLL中的函数和数据。

DLL的export

DLL 中包含有一个表，称为export table（以下简称ET），其中包含了DLL中可以被外部程式使用的所有函数和数据的名字。只有记录在ET中的函数和数据才可以被外部程式所使用（如果没有.DEF文件的话），其它所有没有记录在ET中的函数和数据都被视为是DLL私有的。因此，要将DLL中的函数和数据export只有两个方法：

1、为DLL创建一个.DEF文件（模块定义文件），并在build该DLL时使用这个.DEF文件。使用这种方法使你可以将函数按序号export。

2、在DLL中想要export的函数和数据定义前添加_declspec（dllexport）关键字（对于函数和变量定义，加在最前面；对于class定义，加在class关键字后），这样该函数和数据就会被添加到ET中。使用这种方法函数将按名字export。

在WINDOWS下，无论使用上述的哪一种方法，都必须要将export函数声明为_stdcall。

关于C和C++的兼容问题

如果要写C和C++兼容的DLL，因为在C和C++下使用了不同的名字修饰规则以及不同的调用约定，所以，如果DLL是用C编写和编译的，则在用于C++模块时，函数的声明前应加上extern “C”关键字，以告诉LINKER使用C外部连接（即按照C名字修饰规则在外部模块中寻找函数）；反之，如果DLL是用C++编写和编译的，则在用于C模块时，函数的声明前要加上extern “C++”关键字。VC++通过_cplusplus宏来标识C++程式。如果是C++程式，VC编译器就会为你定义_cplusplus宏。所以在DLL中可以使用如下的技术来解决兼容问题：

#ifdef _cplusplus

extern “C” {

#endif

// 将所有的函数声明放在这里

#ifdef _cplusplus

}

#endif

.DEF文件

　　　 .DEF文件是包含了DLL模块信息的文本文件。其语法结构如下：

　　　 LIBRARY　　　 DLL file name

　　　 DESCRIPTION　　 “descriptions”

　　　 EXPORTS

　　　 Function names　　　@nums

　　　 LIBRARY为关键字，后面紧跟关联的DLL文件名；

DESCRIPTION后为可选的描述字符串，除了增加可读性外没什么用处；

EXPORTS后是export函数的列表，首先是函数名，然后是@符号，后紧跟一十进制数，为该函数的标号，范围从1到DLL可export函数的总数。注意，这里的名字是经过名字修饰后的函数名字，如果是DLL是用C++写的话，那么就很郁闷了。

　　　如果是扩展DLL（extension DLL），并且通过.DEF文件export，那么必须在头文件中添加如下的语句：

#undef AFX_DATA

#define AFX_DATA AFX_EXT_DATA

// 头文件中的其它内容

#undef AFX_DATA

#define AFX_DATA

这些语句确保一些MFC中内部使用的变量被export到外部程式中。例如：在class中通过DECLARE_DYNAMIC获得的CRuntimeClass变量。否则DLL将会无法正确地编译和连接，或外部程式无法正确连接到该DLL。

DLL的import

　　　外部程式的一个源文件要使用DLL中的函数和数据，就像要使用外部模块中的函数和数据一样，必须首先给出函数和数据的声明；对于class则要给出类的定义。这就称为import。对于VC编译器，Import DLL的函数和数据的语法与一般的声明类似，但要在前面加上_declspec（dllimport）关键字（对于函数和变量声明，加在最前面；对于 class定义，加在class关键字后）。如果是函数，则该关键字是可选的，但使用该关键字有可能会导致编译器产生较高效的代码。但对于变量和 class，则必须使用该关键字。

　　　通过使用以下的技术，可以编写在.LIB文件和外部程序源文件通用的头文件：

#ifdef _EXPORTING

#define CLASS_DECLSPEC __declspec(dllexport)

#else

#define CLASS_DECLSPEC __declspec(dllimport)

#endif

编译器提供的_EXPORTING宏可以用于标式该源文件来自DLL文件还是外部程式

一般来讲，在DLL编程过程中，对于导出的函数前都需要加入 extern “C”，

extern 表示这是个全局函数，可以供各个其他的函数调用；

“C” 表示编译时按照 C编译器的方式进行编译，而不是C++。 C++的编译方式考虑了函数重载，所以对函数名进行了新的修饰，产生了所谓的破坏性命名。

不过，也有特殊情况，有三种例外情况可以不加extern “C”：
1。如果不是用C＋＋编译器而是用C编译ＤＬＬ，名字不会变，可以不加extern "C"
2。如果DLL的使用者知道是用C＋＋编译器编译DLL，不加extern “C”也可以，因为他知道名字改变的规则。调用GetProcAddress时，把函数名字改了就是了，改为修饰后的函数名。如 fnDll1 改为 ?fnDll1@@YAHXZ。

例子关键代码如下：
－－－－－－－－－－－－－－－－－－－－－－－－－－－－
DLL部分：
// This is an example of an exported function.
DLL1_API int __cdecl fnDll1(void)
{
return 42;
}
输出的修饰函数名为?fnDll1@@YAHXZ

DLL1_API int __cdecl fnDll1(int a)
{
return 42+a;
}

输出的修饰函数名为?fnDll1@@YAHH@Z
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
EXE部分：
HINSTANCE hModule = LoadLibrary("dll1.dll");
ASSERT(hModule);
typedef int (*fnDll1)();
fnDll1 pfnDll1 = NULL;
//VERIFY(pfnDll1 = (fnDll1)::GetProcAddress(hModule, "fnDll1"));
VERIFY(pfnDll1 = (fnDll1)::GetProcAddress(hModule, "?fnDll1@@YAHXZ"));
ASSERT(pfnDll1() == 42);

typedef int (*fnDll2)(int);
fnDll2 pfnDll2 = NULL;
VERIFY(pfnDll2 = (fnDll2)::GetProcAddress(hModule, "?fnDll1@@YAHH@Z"));
ASSERT(pfnDll2(3) == 45);
－－－－－－－－－－－－－－－－－－－－－－－－－－－

3.上面的2太麻烦了。所以还有一种方法是使用def文件。

(如果DLL使用的是def文件，要删除TestDll.h文件中关键字extern "C",即2者是不能共存的）。

def 文件（模板定义文件），第一个语句必须是 LIBRARY 语句，指出DLL的名字；

EXPORTS语句列出被导出函数的名字；将要输出的函数罗列出来，这个函数名字必须与定义函数的名字完全一致，如此既可以得到

一个没有任何修饰符的函数名了。

被导出的函数可以和一个序号相对应。定义序号时必须在数字前加一个@。例如 isRUINIan @1 //IsRuiNian 函数对应序号为 1

这样的话，我们既可以GetProAddress（hinstance，“IsRuiNian”），也可以 GetProAddress（hinstance，（LPCSTR）1）实现调用。