您的位置:首页 > 其它

使用def文件从dll导出和_declspec(dllexport)导出区别以及调用示例

2015-11-02 10:07 781 查看
在C++中,我们可以通过 __declspec(dllexport) 将函数导出为Dll中供其它程序使用,例如:

_declspec(dllexport) int add(int a, int b);
在这种方式下,如果调用该dll的是一个c++程序(同一个编译器的版本)是没有问题的。但是,如果调用该dll是一个其它语言的程序(如C#、VB),则会出错。究其原因,是因为在C++中存在函数的重载,允许函数重名,因此在编译器生成dll的时候,为了区别重名的程序,会将其进行一定算法进行名称转换。例如,对于前面的add函数,实际的函数名称是如下形式。



因此,我们直接通过函数名add是无法找到该函数的,从而导致调用失败。为了解决这一问题,我们往往在函数前面再加一个extern "C",使用C方式的函数命名规则。
extern "C" _declspec(dllexport) int add(int a, int b);
这样函数的名称就成add了。



这样,我们就需要在每一个函数签名加上"extern "C" _declspec(dllexport)"这一长串声明。如果需要导出的函数较多则显得非常繁琐,也非常难看。为了简化这一过程,MS引入了def文件方便我们操作。
使用Def文件比较简单,只需要在项目中添加一个def文件,然后把我们要导出的函数放在def文件中即可。



Def文件的简单示例如下:
LIBRARY

EXPORTS

add

最后记得在链接器选项中选中使用的def文件(默认情况下,添加def文件时会自动加上该选项,无需手动更改)。



这样,我们的函数无需加那一堆前缀,仍然可以使用默认的int add(int a, int b);形式,但导出后的方式依然是C形式的函数定义。



最后指得一提的是,一般C/C++默认的调用方式是__cdecl,这种方式下需要调用方对函数清栈。如果对外提供api共其它非C++程序使用时,调用方会无法清栈而出错(C#会直接报函数声明不匹配的错误)。因此,对外提供api时还应该将接口声明为__stdcall,让api函数自己清栈。这也是Windows API前面都加上了一个WINAPI的宏的原因。
def文件还有许多其它的高级用法,要进一步了解的话,可以参看一下MS的官方文档:http://msdn.microsoft.com/zh-cn/library/28d6s79h(v=vs.80).aspx
以上转自:<http://www.cnblogs.com/TianFang/archive/2013/05/04/3059073.html>

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

.def 文件必须至少包含下列模块定义语句:
文件中的第一个语句必须是 LIBRARY 语句。此语句将 .def 文件标识为属于 DLL。LIBRARY 语句的后面是 DLL工程的名称。链接器将此名称放到 DLL 的导入库中。
EXPORTS 语句列出名称,可能的话还会列出 DLL 导出函数的序号值。通过在函数名的后面加上 @ 符和一个数字,给函数分配序号值。当指定序号值时,序号值的范围必须是从 1 到 N,其中 N 是 DLL 导出函数的个数。
.def 文件中的注释由每个注释行开始处的分号 (;) 指定,且注释不能与语句共享一行。
以上转自<http://www.2cto.com/kf/201303/197199.html>

创建新的动态链接库DLL项目

1.创建静态项目MathFucsDll

选择 win32项目-->输入MathFuncsDll项目名称->下一步->选择DLL;选择附加选项的空项目->完毕。(或者不选选择附加选项的空项目也行,就是默认)

2.创建库函数

[cpp]
//MyMathFuncs.cpp
int nDataBase=1;//全局变量
int Add(int a,int b)
{
return (a+b)*nDataBase;
}
int _stdcall Sub(int a,int b)
{
return (a-b)*nDataBase;
}
int _cdecl Multiply(int a,int b)
{
return a*b;
}


3.创建def文件

[cpp]
//MyMathFuncs.def
//LIBRARY和EXPORTS不可以小写,且LIBRARY后面的名称要与工程名相同
;
LIBRARY   MathFuncsDll
EXPORTS
Add @3
Sub @5
Multiply @1
nDataBase  DATA
;nDataBase全局变量,只写 (nDataBase);(nDataBase  data);(nDataBase  @2)都行


创建引用动态链接库的应用程序

1.创建引用动态链接库的控制台应用程序:

在同一个解决方案中添加项目MyExecRefsDll:选择 win32控制台应用程序->输入MyExecRefsDll项目名称->下一步->选择控制台应用程序;选择附加选项的空项目->完毕

2.在应用程序中使用动态链接库的功能

项目,引用->通用属性->框架和引用->添加引用->会出现MathFuncsDll的项目名称和项目目录->确定 (最简单的一种)
或者是,添加库目录及附加库:项目,属性->连接器->常规->附加库目录:如$(OutDir)
项目,属性->连接器->输入->附加依赖项:MathFuncsDll.lib;
或者是在代码中添加:#pragma comment(lib,"MathFuncsDll.lib") 且MathFuncsDll.dll必须与MyExecRefsDll.exe文件在同一个目录

3.程序

[cpp]
#include "stdafx.h"
#include <iostream>
using namespace std;
extern int _declspec(dllimport) nDataBase;//引用dll中的全局变量
//声明函数,需与Dll中的函数定义一致(包括其函数调用修饰词)
int Add(int a,int b);
int _stdcall Sub(int a,int b);
int _cdecl Multiply(int a,int b);

int _tmain(int argc, _TCHAR* argv[])
{
nDataBase=2;
cout<<Add(1,2)<<endl;//6
cout<<Sub(3,4)<<endl;//-2
cout<<Multiply(4,5)<<endl;//20
return 0;
}


比较使用_declspec(dllexport)与使用.def文件来导出Dll函数的异同

相同:创建项目和引用动态库相同
不同:
定义时:.def的要有其文件(LIBRARY EXPORTS),而另外一种则需要在其函数前添加_declspec(dllexport)
使用时:.def使用函数前要有函数声明,而使用_declspec(dllexport)的要添加头文件

另附_declspec(dllexport)导出示例:
//Out.Api.h 导出函数的声明
#ifdef __cplusplus
extern "C"
{
#endif

//#define DLL_NO_DEF_FILE 定义到项目的预处理器中,不应该在此处定义.在导出Dll项目中定义,此处是导出接口函数的意思,在引用的项目中没定义时//,是导入接口函数的意思。就能正常引用了。
#ifdef DLL_NO_DEF_FILE
#define NO_DEF_FILE _declspec(dllexport)
#else
#define NO_DEF_FILE _declspec(dllimport)
#endif

int NO_DEF_FILE DoAdd(int a, int b);

#ifdef __cplusplus
}
#endif
函数实现:
#include "stdafx.h"
#include "Out_Api.h"

int NO_DEF_FILE DoAdd( int a, int b )
{
return a + b;
}


调用动态库DLL的示例:

#include "../隐式调用Dll/Out_Api.h"
#pragma comment( lib, "../Debug/隐式调用Dll.lib" )

int _tmain(int argc, _TCHAR* argv[])
{
int sum = DoAdd( 4, 5 );

return 0;
}
另外参考:

使用 .def 文件从 DLL 导出
https://msdn.microsoft.com/zh-cn/library/d91k01sh(v=vs.80).aspx
使用 __declspec(dllexport) 从 DLL 导出
https://msdn.microsoft.com/zh-cn/library/a90k134d(v=vs.80).aspx
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: