C#中怎么调用WinAPI函数

在C#吃常用调用一些API函数,那么怎样才能正确的调用API函数呢,如下:

 

一、调用API格式

 

//引用这名空间,简化后的代码

usingSystem.Runtime.InteropServices;

 

//使用DllImportAttribute特性来引入api函数,注意声明的凡空方法,即方法体为空。

[DllImport(“user32.dll”)]

publicstaticexternReturnTypeFunctionName(typearg1,typearg2,…);

 

 

好行使字段进一步求证特性,用逗号隔开,如:

[DllImport(“kernel32″,EntryPoint=”GetVersionEx”,SetLastError=true)]

 

DllImportAttribute特性的几乎单国有字段如下:

 

1、CallingConvention:指示为非托管实现传递方式参数时所用的CallingConvention值。

CallingConvention.Cdecl:调用方清理堆栈。它要您能够调用具有varargs的函数。

CallingConvention.StdCall:被调用方清理堆栈。它是打托管代码调用非托管函数的默认约定。

 

2、CharSet:控制调用函数的名版本及指示如何为方封送String参数。

是字段被装置也CharSet值之一。如果CharSet字段设置也Unicode,则装有字符串参数在传递及非托管实现之前还更换成为Unicode字符。这尚造成向DLLEntryPoint的名号被增加字母“W”。如果这字段设置为Ansi,则字符串将更换成ANSI字符串,同时于DLLEntryPoint的称被益字母“A”。大多数Win32API用这种增加“W”或“A”的约定。如果CharSet设置为Auto,则这种转移就是同平台有关的(在WindowsNT上呢Unicode,在Windows98上吧Ansi)。CharSet的默认值为Ansi。CharSet字段为用于确定以于指定的DLL导入哪个版本的函数。CharSet.Ansi和CharSet.Unicode的名目匹配规则大不相同。对于Ansi来说,如果将EntryPoint设置为“MyMethod”且她在的话,则赶回“MyMethod”。如果DLL中从不“MyMethod”,但在“MyMethodA”,则赶回“MyMethodA”。对于Unicode来说则刚刚相反。如果拿EntryPoint设置也“MyMethod”且其存在的话,则归“MyMethodW”。如果DLL中未有“MyMethodW”,但存在“MyMethod”,则回“MyMethod”。如果采取的是Auto,则匹配规则和平台有关(在WindowsNT上吧Unicode,在Windows98上吧Ansi)。如果ExactSpelling设置也true,则只有当DLL中留存“MyMethod”时才回来“MyMethod”。

 

3、EntryPoint:指示而调用的DLL入口点的号或序号。

如果您的办法名无思量跟api函数同名的话,一定要指定此参数,例如:

[DllImport(“user32.dll”,CharSet=”CharSet.Auto”,EntryPoint=”MessageBox”)]

publicstaticexternintMsgBox(IntPtrhWnd,stringtxt,stringcaption,inttype);

 

4、ExactSpelling:指示是否应改非托管DLL中之入口点的名号,以和CharSet字段受到指定的CharSet值相对应。如果也true,则当DllImportAttribute.CharSet字段设置也CharSet的Ansi值时,向方名称被追加字母A,当DllImportAttribute.CharSet字段设置为CharSet的Unicode值时,向方的称号被追加字母W。此字段的默认值是false。

 

5、PreserveSig:指示托管方签名不答应转换成回到HRESULT、并且可能发生一个对应于返回值的叠加[out,retval]参数的非托管签名。

 

6、SetLastError:指示让调用方在起属于性化方法返回之前将调用Win32APISetLastError。true指示调用方将调用SetLastError,默认为false。运行时封送拆收器将调用GetLastError并缓存返回的价,以防止其被其他API调用重写。用户可经调用GetLastWin32Error来搜寻错误代码。

 

老二、参数类型:

1、数值型直接用相应的就是只是。(DWORD->int,或uint,WORD->Int16)

2、API中字符串指针类型->.net中string,或者数组,如byte[]

3、API中句柄(dWord)->.net中IntPtr

4、API中组织->.net中组织要类。注意这种景象下,要先行用StructLayout特性限定声明结构还是近乎

 

公语言运行库利用StructLayoutAttribute控制类或组织的数据字段在托管内存中的物理布局,即类还是组织要遵循某种方式排列。如果只要将接近传递让需要指定布局之非托管代码,则显式控制类布局是根本之。它的构造函数中之所以LayoutKind值初始化StructLayoutAttribute类的初实例。LayoutKind.Sequential用于强制将成员按照那现出的相继进行逐个布局。

LayoutKind.Explicit用于控制每个数据成员的规范位置。利用Explicit,每个成员要动FieldOffsetAttribute指示此字段以品种受到之职务。如:

[StructLayout(LayoutKind.Explicit,Size=16,CharSet=CharSet.Ansi)]

publicclassMySystemTime

{

[FieldOffset(0)]publicushortwYear;

[FieldOffset(2)]publicushortwMonth;

[FieldOffset(4)]publicushortwDayOfWeek;

[FieldOffset(6)]publicushortwDay;

[FieldOffset(8)]publicushortwHour;

[FieldOffset(10)]publicushortwMinute;

[FieldOffset(12)]publicushortwSecond;

[FieldOffset(14)]publicushortwMilliseconds;

}

 

如:下面是API函数CreateNamedPipe的原函数:

WINBASEAPI

HANDLE

WINAPI

CreateNamedPipeW(

LPCWSTRlpName,

DWORDdwOpenMode,

DWORDdwPipeMode,

DWORDnMaxInstances,

DWORDnOutBufferSize,

DWORDnInBufferSize,

DWORDnDefaultTimeOut,

LPSECURITY_ATTRIBUTESlpSecurityAttributes

);

在C#面临可这么调用(封装在类NamedPipeNative当中):

[DllImport(“kernel32.dll”,SetLastError=true)]

publicstaticexternIntPtrCreateNamedPipe(

       StringlpName,                                                        

       uintdwOpenMode,                                                  

       uintdwPipeMode,                                                   

       uintnMaxInstances,                                                

       uintnOutBufferSize,                                         

      
uintnInBufferSize,

      
uintnDefaultTimeOut,

       IntPtrpipeSecurityDescriptor       

);

 

运实例:

IntPtrm_HPipe=NamedPipeNative.CreateNamedPipe(m_PipeName,

NamedPipeNative.PIPE_ACCESS_DUPLEX,//数据双工通信

NamedPipeNative.PIPE_TYPE_MESSAGE|NamedPipeNative.PIPE_WAIT,//字节约流,并且阻塞

100,//最深实例个数

128,//流出数据缓冲大小

128,//流入数据缓冲大小

150,//超时,毫秒

IntPtr.Zero//安全信息

);

其中CreateNamedPipe函数,还有PIPE_ACCESS_DUPLEX,PIPE_TYPE_MESSAGE,PIPE_WAIT等字段都封装在类NamedPipeNative当中,以便为调用。

相关文章