C# dllimport

一、DllImport是System.Runtime.InteropServices命名空间下的一个属性类,其功能是提供从非托管DLL导出的函数的必要调用信息

DllImport的定义如下:

public class DllImportAttribute:System.Attribute

{

  public DllImportAttribute(string dllName) {…} //定位参数为dllName

  public CallingConvention CallingConvention; //入口点调用约定

  public CharSet CharSet;    //入口点采用的字符接

  public string EntryPoint;  //入口点名称

  public bool ExactSpelling;   //是否必须与指示的入口点拼写完全一致,默认false

  public bool PreserveSig;  //方法的签名是被保留还是被转换

  public bool SetLastError; //FindLastError方法的返回值保存在这里

  public string Value { get {…} }

}

用法:

[DLLImport(“DLL文件名称”)]

修饰符   extern    返回值类型   方法名称(参数列表) ;

用法示例:

[DllImport("kernel32.dll")]

private static extern longWritePrivateProfileString(string section,string key,string val,stringfilePath);

DllImport会按照以下顺序自动去寻找:

1、exe所在目录

2、System32目录

3、环境变量目录

所以只需要你把引用的DLL 拷贝到这三个目录下,就可以不用写路径了。

 

C#在调用非托管的dll时,作为最低要求,必须提供包含入口点的 DLL 的名称,如下。

[DllImport("halcon_c32.dll")]

参数详解:       

1、DllImport只能放置在方法声明上。

2、DllImport具有单个定位参数:指定包含被导入方法的 dll 名称的 dllName 参数。

3、DllImport具有五个命名参数: 

(a)CallingConvention 参数指示入口点的调用约定。这是指定调用在非托管代码中实现的方法所需的调用约定。

如果未指定 CallingConvention,则使用默认值 CallingConvention.Winapi。即CallingConvention.StdCall。

调用约定需要设置为与dll函数所在文件的调用约定一致。如dll中函数所在的c++文件的调用约定为cdecl,如下图所示:则在C#中需设置CallingConvention =CallingConvention.Cdecl.

C# dllimport

否则会报如下错误:

C# dllimport

CallingConvention有五种方式:

CallingConvention =CallingConvention.StdCall

CallingConvention = CallingConvention.Cdecl

CallingConvention =CallingConvention.FastCall

CallingConvention =CallingConvention.ThisCall

CallingConvention =CallingConvention.Winapi

默认情况下,C和C++使用的Cdecl调用,但编组使用StdCall调用匹配的WindowsAPI。对于FastCall、ThisCall、Winapi这三种调用方式尚不清楚。

调用约定(Calling   convention):决定函数参数传送时入栈和出栈的顺序,由调用者还是被调用者把参数弹出栈,以及编译器用来识别函数名字的修饰约定 .

函数调用约定有多种,这里简单说一下:   

  1)__stdcall调用约定相当于16位动态库中经常使用的PASCAL调用约定。在32位的VC++5.0中PASCAL调用约定不再被支持(实际上它已被定义为__stdcall。除了__pascal外,__fortran和__syscall也不被支持),取而代之的是__stdcall调用约定。两者实质上是一致的,即函数的参数自右向左通过栈传递,被调用的函数在返回前清理传送参数的内存栈,但不同的是函数名的修饰部分(关于函数名的修饰部分在后面将详细说明)。    _stdcall是Pascal程序的缺省调用方式,通常用于Win32   Api中,函数采用从右到左的压栈方式,自己在退出时清空堆栈。VC将函数编译后会在函数名前面加上下划线前缀,在函数名后加上"@"和参数的字节数。

  2)C调用约定(即用__cdecl关键字说明)按从右至左的顺序压参数入栈,由调用者把参数弹出栈。对于传送参数的内存栈是由调用者来维护的(正因为如此,实现可变参数的函数只能使用该调用约定)。另外,在函数名修饰约定方面也有所不同。  _cdecl是C和C++程序的缺省调用方式。每一个调用它的函数都包含清空堆栈的代码,所以产生的可执行文件大小会比调用_stdcall函数的大。函数采用从右到左的压栈方式。VC将函数编译后会在函数名前面加上下划线前缀。是MFC缺省调用约定。

 3)__fastcall调用约定是“人”如其名,它的主要特点就是快,因为它是通过寄存器来传送参数的(实际上,它用ECX和EDX传送前两个双字(DWORD)或更小的参数,剩下的参数仍旧自右向左压栈传送,被调用的函数在返回前清理传送参数的内存栈),在函数名修饰约定方面,它和前两者均不同。_fastcall方式的函数采用寄存器传递参数,VC将函数编译后会在函数名前面加上"@"前缀,在函数名后加上"@"和参数的字节数。

 4)thiscall仅仅应用于“C++”成员函数。this指针存放于CX寄存器,参数从右到左压。thiscall不是关键词,因此不能被程序员指定。

 5)naked   call采用1-4的调用约定时,如果必要的话,进入函数时编译器会产生代码来保存ESI,EDI,EBX,EBP寄存器,退出函数时则产生代码恢复这些寄存器的内容。naked   call不产生这样的代码。naked   call不是类型修饰符,故必须和_declspec共同使用。

  关键字   __stdcall、__cdecl和__fastcall可以直接加在要输出的函数前,也可以在编译环境的Setting.../C/C++   /Code   Generation项选择。当加在输出函数前的关键字与编译环境中的选择不同时,直接加在输出函数前的关键字有效。它们对应的命令行参数分别为/Gz、 /Gd和/Gr。缺省状态为/Gd,即__cdecl。

      要完全模仿PASCAL调用约定首先必须使用__stdcall调用约定,至于函数名修饰约定,可以通过其它方法模仿。还有一个值得一提的是WINAPI 宏,

Windows.h支持该宏,它可以将出函数翻译成适当的调用约定,在WIN32中,它被定义为__stdcall。使用WINAPI宏可以创建自己的APIs。

总结一点常用的:     

关于PASCAL这种调用约定的函数都是由它本身来清栈,而__cdecl的函数都是由调用者来清栈. 实际用的时候,个人觉得两者最大的差别在于:__cdecl的函数参数个数可以声明为不确定,比如printf,scanf之类,而PASCAL的函数是不可以这样做的,如果这样的话它不知道实参有多少个。     

VC里面:PASCAL==CALLBACK==WINAPI==__stdcall

默认情况下,C和C++使用的Cdecl调用,但编组使用StdCall调用匹配的WindowsAPI

调用WinAPI的使用stdcall,调用C++/C的使用cdelcall

b、CharSet 参数指示用在入口点中的字符集。如果未指定 CharSet,则使用默认值 CharSet.Auto。

c、EntryPoint 参数给出 dll 中入口点的名称。如果未指定EntryPoint,则使用方法本身的名称。         

d、ExactSpelling 参数指示EntryPoint 是否必须与指示的入口点的拼写完全匹配。如果未指定 ExactSpelling,则使用默认值 false。         

e、PreserveSig 参数指示方法的签名应当被保留还是被转换。当签名被转换时,它被转换为一个具有 HRESULT返回值和该返回值的一个名为 retval 的附加输出参数的签名。如果未指定 PreserveSig,则使用默认值 true。         

f、SetLastError 参数指示方法是否保留Win32"上一错误"。如果未指定 SetLastError,则使用默认值 false。       

4、它是一次性属性类。     

  

5、此外,用 DllImport 属性修饰的方法必须具有extern 修饰符。