模块定义 (.Def) 文件

参考资料:

http://msdn.microsoft.com/zh-cn/library/28d6s79h


模块定义 (.def) 文件是包含一个或多个描述 DLL 各种特性的 Module 语句的文本文件。如果不使用__declspec(dllexport) 关键字导出 DLL 的函数,则 DLL 需要 .def 文件。

.def 文件必须至少包含下列模块定义语句:

  • 文件中的第一个语句必须是 LIBRARY 语句。 此语句将 .def 文件标识为属于 DLL。LIBRARY 语句的后面是 DLL 的名称。链接器将此名称放到 DLL 的导入库中。

  • EXPORTS 语句列出名称,可能的话还会列出 DLL 导出函数的序号值。 通过在函数名的后面加上 @ 符和一个数字,给函数分配序号值。当指定序号值时,序号值的范围必须是从 1 到 N,其中 N 是 DLL 导出函数的个数。如果希望按序号导出函数,请参见按序号而不是按名称从 DLL 导出函数以及本主题。

例如,包含实现二进制搜索树的代码的 DLL 看上去可能像下面这样:

LIBRARY   "BTREE"

 EXPORTS
; Explicit exports can go here
 Insert @1
Delete @2
Member @3
Min @4

如果使用 MFC DLL 向导创建 MFC DLL,则向导将为您创建主干 .def 文件并将其自动添加到项目中。 添加要导出到此文件的函数名。 对于非 MFC DLL,必须亲自创建 .def 文件并将其添加到项目中。

EXPORTS 

definitions 

EXPORTS 语句引入了一个由一个或多个 definitions(导出的函数或数据)组成的节.每个定义必须在单独一行上.EXPORTS 关键字可以在第一个定义所在的同一行上或在前一行上..def 文件可以包含一个或多个 EXPORTS 语句. 


导出 definitions 的语法为: 


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

entryname 是要导出的函数名或变量名.这是必选项.如果导出的名称与 DLL 中的名称不同,则通过 internalname 指定 DLL 中导出的名称.例如,如果 DLL 导出函数 func1(),要将它用作 func2(),则应指定: 


EXPORTS 

func2=func1

如果导出 C++ 文件中的函数,必须将修饰名放到 .def 文件中,或者通过extern “C”定义具有标准 C 链接的导出函数。如果需要将修饰名放到 .def 文件中,则可以通过使用DUMPBIN 工具或 /MAP 链接器选项来获取修饰名。请注意,编译器产生的修饰名是编译器特定的。如果将 Visual C++ 编译器产生的修饰名放到 .def 文件中,则链接到 DLL 的应用程序必须也是用相同版本的 Visual C++ 生成的,这样调用应用程序中的修饰名才能与 DLL 的 .def 文件中的导出名相匹配。

如果生成扩展 DLL 并使用 .def 文件导出,则将下列代码放在包含导出类的头文件的开头和结尾:

#undef AFX_DATA
#define AFX_DATA AFX_EXT_DATA
// <body of your header file>
#undef AFX_DATA
#define AFX_DATA

这些代码行确保内部使用的 MFC 变量或添加到类的变量是从扩展 DLL 导出(或导入)的。例如,当使用DECLARE_DYNAMIC 派生类时,该宏扩展以将CRuntimeClass 成员变量添加到类。省去这四行代码可能会导致不能正确编译或链接 DLL,或在客户端应用程序链接到 DLL 时导致错误。

当生成 DLL 时,链接器使用 .def 文件创建导出 (.exp) 文件和导入库 (.lib) 文件。 然后,链接器使用导出文件生成 DLL 文件。


你可能感兴趣的:(模块定义 (.Def) 文件)