MSDN中的dllexport与dllimport定义

更好使用MSDN是用好VC的最好法宝。

摘录：

使用 __declspec(dllexport) 从 DLL 导出

Microsoft 在 Visual C++ 的 16 位编译器版本中引入了 __export，使编译器得以自动生成导出名并将它们放到一个 .lib 文件中。然后，此 .lib 文件就可以像静态 .lib 那样用于与 DLL 链接。

在 32 位编译器版本中，可以使用 __declspec(dllexport) 关键字从 DLL 导出数据、函数、类或类成员函数。__declspec(dllexport) 会将导出指令添加到对象文件中，因此您不需要使用 .def 文件。

当试图导出 C++ 修饰函数名时，这种便利最明显。由于对名称修饰没有标准规范，因此导出函数的名称在不同的编译器版本中可能有所变化。如果使用 __declspec(dllexport)，仅当解决任何命名约定更改时才必须重新编译 DLL 和依赖 .exe 文件。

许多导出指令（如序号、NONAME 和 PRIVATE）只能在 .def 文件中创建，并且必须使用 .def 文件来指定这些属性。不过，在 .def 文件的基础上另外使用 __declspec(dllexport) 不会导致生成错误。

若要导出函数，__declspec(dllexport) 关键字必须出现在调用约定关键字的左边（如果指定了关键字）。例如：

__declspec(dllexport) void __cdecl Function1(void);

若要导出类中的所有公共数据成员和成员函数，关键字必须出现在类名的左边，如下所示：

class __declspec(dllexport) CExampleExport : public CObject
{ ... class definition ... };

生成 DLL 时，通常创建一个包含正在导出的函数原型和/或类的头文件，并将 __declspec(dllexport) 添加到头文件中的声明中。若要提高代码的可读性，请为 __declspec(dllexport) 定义一个宏并对正在导出的每个符号使用该宏：

#define DllExport   __declspec( dllexport )

__declspec(dllexport) 将函数名存储在 DLL 的导出表中。如果希望优化表的大小，请参见按序号而不是按名称从 DLL 导出函数。

Note 注意

将 DLL 源代码从 Win16 移植到 Win32 时，请用 __declspec(dllexport) 替换 __export 的每个实例。

作为参考，请在 Win32 Winbase.h 头文件中搜索。它包含 __declspec(dllimport) 的用法示例。

您希望做什么？

您想进一步了解什么？

请参见

概念

从 DLL 导出

使用 __declspec(dllimport) 导入到应用程序中

如果一个程序使用 DLL 定义的公共符号，就说该程序是在导入公共符号。为使用 DLL 生成的应用程序创建头文件时，在公共符号的声明上使用 __declspec(dllimport)。不论是用 .def 文件导出还是用 __declspec(dllexport) 关键字导出，__declspec(dllimport) 关键字均有效。

若要提高代码的可读性，请为 __declspec(dllimport) 定义一个宏，然后使用此宏声明每个导入的符号：

#define DllImport   __declspec( dllimport )

DllImport int  j;
DllImport void func();

在函数声明上使用 __declspec(dllimport) 是可选操作，但如果使用此关键字，编译器将生成更有效的代码。但是，为使导入的可执行文件能够访问 DLL 的公共数据符号和对象，必须使用 __declspec(dllimport)。请注意，DLL 的用户仍然需要与导入库链接。

对 DLL 和客户端应用程序可以使用相同的头文件。为此，请使用特殊的预处理器符号来指示是生成 DLL 还是生成客户端应用程序。例如：

#ifdef _EXPORTING
   #define CLASS_DECLSPEC    __declspec(dllexport)
#else
   #define CLASS_DECLSPEC    __declspec(dllimport)
#endif

class CLASS_DECLSPEC CExampleA : public CObject
{ ... class definition ... };