vc 模块定义(def) 文件

vc 模块定义 (.def) 文件2008年08月03日 星期日 16:33模块定义 (.def) 文件为链接器提供有关被链接程序的导出、属性及其他方面的信息。生成 DLL 时，.def 文件最有用。由于存在可代替模块定义语句使用的链接器选项，通常不需要 .def 文件。也可以将 __declspec(dllexport) 用作指定导出函数的手段。

在链接器阶段可以使用 /DEF（指定模块定义文件）链接器选项调用 .def 文件。

如果生成的 .exe 文件没有导出，使用 .def 文件将使输出文件较大并降低加载速度。

有关更多信息，请参见下列章节：

模块定义语句的规则

EXPORTS

HEAPSIZE

LIBRARY

NAME

SECTIONS

STACKSIZE

STUB

VERSION

保留字

[hr]
EXPORTS

引入了一个由一个或多个 definitions（导出的函数或数据）组成的节。每个定义必须在单独一行上。

复制代码
EXPORTS
definitions

备注
EXPORTS 关键字可以在第一个定义所在的同一行或前一行上。.def 文件可以包含一个或多个 EXPORTS 语句。

导出 definitions 的语法为：

复制代码
    entryname[=internalname] [@ordinal [NONAME]] [PRIVATE] [DATA]

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

复制代码
EXPORTS
func2=func1

@ordinal 允许指定是序号而不是函数名将进入 DLL 的导出表。这有助于最小化 DLL 的大小。.LIB 文件将包含序号与函数之间的映射，这使您得以像通常在使用 DLL 的项目中那样使用函数名。

可选的 NONAME 关键字允许只按序号导出，并减小结果 DLL 中导出表的大小。但是，如果要在 DLL 上使用 GetProcAddress，则必须知道序号，因为名称将无效。

可选的 PRIVATE 关键字禁止将 entryname 放到由 LINK 生成的导入库中。它对同样是由 LINK 生成的图像中的导出无效。

可选的 DATA 关键字指定导出的是数据，而不是代码。例如，可以导出数据变量，如下所示：

复制代码
EXPORTS
i DATA

当对同一导出使用 PRIVATE 和 DATA 时，PRIVATE 必须位于 DATA 的前面。

有三种导出定义的方法，按照建议的使用顺序依次为：

源代码中的 __declspec(dllexport) 关键字

.def 文件中的 EXPORTS 语句

LINK 命令中的 /EXPORT 规范

所有这三种方法可以用在同一个程序中。LINK 在生成包含导出的程序时还创建导入库，除非生成中使用了 .exp 文件。

以下是 EXPORTS 节的示例：

复制代码
EXPORTS
   DllCanUnloadNow @1 PRIVATE   DATA
   DllWindowName = Name DATA
   DllGetClassObject   @4 NONAME   PRIVATE
   DllRegisterServer   @7
   DllUnregisterServer

注意，使用 .def 文件从 DLL 中导出变量时，不需要在变量上指定 __declspec(dllexport)。但是，在任何使用 DLL 的文件中，仍必须在数据声明上使用 __declspec(dllimport)。
LIBRARY

告知 LINK 创建 DLL。LINK 同时还创建导入库，除非生成中使用了 .exp 文件。

复制代码
LIBRARY [library][BASE=address]

备注
library 参数指定 DLL 的名称。也可以使用 /OUT 链接器选项指定 DLL 输出名。

BASE=address 参数设置操作系统用来加载 DLL 的基址。该参数重写 0x10000000 的默认 DLL 位置。有关基址的详细信息，请参见 /BASE 选项说明。

请记住，在生成 DLL 时使用 /DLL 链接器选项。