C#调用系统API

在C++，dephil等语言可以轻使用系统API，当然，在C#中也是可以做到的。 一.声明及其参数。 首先必须要做的就是引用命名空间。 using System.Runtime.InteropServices; 下来就可以用DllImport来引入API函数了。 例如：[DllImport("user32.dll")] public static extern ReturnType FunctionName(type arg1,type arg2,...); 这里是一个空的方法方体。调用的时候和以前没什么区别。 DllImportAttribute后面还有很多属性，我们来看一下： [ DllImport( "kernel32", EntryPoint="MessageBox,......" )] DllImportAttribute特性的公共字段如下： 1、CallingConvention 指示向非托管实现传递方法参数时所用的 CallingConvention 值。 　 CallingConvention.Cdecl : 调用方清理堆栈。它使您能够调用具有 varargs 的函数。 　 CallingConvention.StdCall : 被调用方清理堆栈。它是从托管代码调用非托管函数的默认约定。 2、CharSet 控制调用函数的名称版本及指示如何向方法封送 String 参数。 　 　此字段被设置为 CharSet 值之一。如果 CharSet 字段设置为 Unicode，则所有字符串参数在传递到非托管实现之前都转换成 Unicode 字符。这还导致向 DLL EntryPoint 的名称中追加字母“W”。如果此字段设置为 Ansi，则字符串将转换成 ANSI 字符串，同时向 DLL EntryPoint 的名称中追加字母“A”。 　　大多数 Win32 API 使用这种追加“W”或“A”的约定。如果 CharSet 设置为 Auto，则这种转换就是与平台有关的（在 Windows NT 上为 Unicode，在 Windows 98 上为 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，则匹配规则与平台有关（在 Windows NT 上为 Unicode，在 Windows 98 上为 Ansi）。如果 ExactSpelling 设置为 true，则只有当 DLL 中存在“MyMethod”时才返回“MyMethod”。 3、EntryPoint 指示要调用的 DLL 入口点的名称或序号。 　　如果你的方法名不想与api函数同名的话，一定要指定此参数。 4、ExactSpelling 指示是否应修改非托管 DLL 中的入口点的名称，以与 CharSet 字段中指定的 CharSet 值相对应。如果为 true，则当 DllImportAttribute.CharSet 字段设置为 CharSet 的 Ansi 值时，向方法名称中追加字母 A，当 DllImportAttribute.CharSet 字段设置为 CharSet 的 Unicode 值时，向方法的名称中追加字母 W。此字段的默认值是 false。 5、PreserveSig 指示托管方法签名不应转换成返回 HRESULT、并且可能有一个对应于返回值的附加 [out, retval] 参数的非托管签名。 6、SetLastError 指示被调用方在从属性化方法返回之前将调用 Win32 API SetLastError。 true 指示调用方将调用 SetLastError，默认为 false。运行时封送拆收器将调用 GetLastError 并缓存返回的值，以防其被其他 API 调用重写。用户可通过调用 GetLastWin32Error 来检索错误代码。 二.类型转换 在写这些空方法体的时候，有些类型我们却没有，这样，我们就需要把它转换。有的要用到构造，枚举，甚至还会用到委托(delegate)。 　1、数值型直接用对应的就可。（DWORD -> int , WORD -> Int16） 　2、API中字符串指针类型 -> .net中string 　3、API中句柄 (dWord) -> .net中IntPtr 　4、API中结构 -> .net中结构或者类。注意这种情况下，要先用StructLayout特性限定声明结构或类 布局选项 描述 LayoutKind.Automatic 为了提高效率允许运行态对类型成员重新排序。 注意：永远不要使用这个选项来调用不受管辖的动态链接库函数。 LayoutKind.Explicit 对每个域按照FieldOffset属性对类型成员排序 LayoutKind.Sequential 对出现在受管辖类型定义地方的不受管辖内存中的类型成员进行排序。 三.成员传递 &结构成员的传递：& 下面的例子说明如何在受管辖代码中定义一个点和矩形类型，并作为一个参数传递给User32.dll库中的PtInRect函数， 函数的不受管辖原型声明如下： BOOL PtInRect(const RECT *lprc, POINT pt); 注意你必须通过引用传递Rect结构参数，因为函数需要一个Rect的结构指针。 [C#] using System.Runtime.InteropServices; [StructLayout(LayoutKind.Sequential)] public struct Point { public int x; public int y; } [StructLayout(LayoutKind.Explicit] public struct Rect { [FieldOffset(0)] public int left; [FieldOffset(4)] public int top; [FieldOffset(8)] public int right; [FieldOffset(12)] public int bottom; } class Win32API { [DllImport("User32.dll")] public static extern Bool PtInRect(ref Rect r, Point p); } 类似你可以调用GetSystemInfo函数获得系统信息： ? using System.Runtime.InteropServices; [StructLayout(LayoutKind.Sequential)] public struct SYSTEM_INFO { public uint dwOemId; public uint dwPageSize; public uint lpMinimumApplicationAddress; public uint lpMaximumApplicationAddress; public uint dwActiveProcessorMask; public uint dwNumberOfProcessors; public uint dwProcessorType; public uint dwAllocationGranularity; public uint dwProcessorLevel; public uint dwProcessorRevision; } [DllImport("kernel32")] static extern void GetSystemInfo(ref SYSTEM_INFO pSI); SYSTEM_INFO pSI = new SYSTEM_INFO(); GetSystemInfo(ref pSI); 注意结构作为参数时候，一般前面要加上ref修饰符，否则会出现错误：对象的引用没有指定对象的实例。 [ DllImport( "kernel32", EntryPoint="GetVersionEx" )] 　　public static extern bool GetVersionEx2( ref OSVersionInfo2 osvi ); &类成员的传递& 同样只要类具有一个固定的类成员布局，你也可以传递一个类成员给一个不受管辖的动态链接库函数，下面的例子主要说明如何传递一个sequential顺序定义的MySystemTime类给User32.dll的GetSystemTime函数, 函数用C/C++调用规范如下: void GetSystemTime(SYSTEMTIME* SystemTime); 不像传值类型,类总是通过引用传递参数. [C#] [StructLayout(LayoutKind.Sequential)] public class MySystemTime { public ushort wYear; public ushort wMonth; public ushort wDayOfWeek; public ushort wDay; public ushort wHour; public ushort wMinute; public ushort wSecond; public ushort wMilliseconds; } class Win32API { [DllImport("User32.dll")] public static extern void GetSystemTime(MySystemTime st); } &回调函数的传递:& 从受管辖的代码中调用大多数动态链接库函数,你只需创建一个受管辖的函数定义，然后调用它即可,这个过程非常直接。 如果一个动态链接库函数需要一个函数指针作为参数，你还需要做以下几步： 首先，你必须参考有关这个函数的文档，确定这个函数是否需要一个回调；第二，你必须在受管辖代码中创建一个回调函数；最后，你可以把指向这个函数的指针作为一个参数创递给DLL函数,. 回调函数及其实现: 回调函数经常用在任务需要重复执行的场合,譬如用于枚举函数,譬如Win32 API 中的EnumFontFamilies(字体枚举), EnumPrinters(打印机), EnumWindows (窗口枚举)函数. 下面以窗口枚举为例,谈谈如何通过调用EnumWindow 函数遍历系统中存在的所有窗口 分下面几个步骤: 1. 在实现调用前先参考函数的声明 BOOL EnumWindows(WNDENUMPROC lpEnumFunc, LPARMAM IParam) 显然这个函数需要一个回调函数地址作为参数. 2. 创建一个受管辖的回调函数,这个例子声明为代表类型(delegate),也就是我们所说的回调,它带有两个参数hwnd和lparam,第一个参数是一个窗口句柄，第二个参数由应用程序定义，两个参数均为整形。 　　当这个回调函数返回一个非零值时，标示执行成功，零则暗示失败，这个例子总是返回True值，以便持续枚举。 3. 最后创建以代表对象(delegate)，并把它作为一个参数传递给EnumWindows 函数，平台会自动地把代表转化成函数能够识别的回调格式。 [C#] using System; using System.Runtime.InteropServices; public delegate bool CallBack(int hwnd, int lParam); public class EnumReportApp { [DllImport("user32")] public static extern int EnumWindows(CallBack x, int y); public static void Main() { CallBack myCallBack = new CallBack(EnumReportApp.Report); EnumWindows(myCallBack, 0); } public static bool Report(int hwnd, int lParam) { Console.Write("窗口句柄为"); Console.WriteLine(hwnd); return true; } } &指针类型参数传递：& 　在Windows API函数调用时，大部分函数采用指针传递参数，对一个结构变量指针，我们除了使用上面的类和结构方法传递参数之外，我们有时还可以采用数组传递参数。 　下面这个函数通过调用GetUserName获得用户名 BOOL GetUserName( LPTSTR lpBuffer, // 用户名缓冲区 LPDWORD nSize // 存放缓冲区大小的地址指针 ); 　 [DllImport("Advapi32.dll", EntryPoint="GetComputerName", ExactSpelling=false, SetLastError=true)] static extern bool GetComputerName ( [MarshalAs(UnmanagedType.LPArray)] byte[] lpBuffer, [MarshalAs(UnmanagedType.LPArray)] Int32[] nSize ); 　这个函数接受两个参数，char * 和int *,因为你必须分配一个字符串缓冲区以接受字符串指针，你可以使用String类代替这个参数类型，当然你还可以声明一个字节数组传递ANSI字符串，同样你也可以声明一个只有一个元素的长整型数组，使用数组名作为第二个参数。上面的函数可以调用如下： byte[] str=new byte[20]; Int32[] len=new Int32[1]; len[0]=20; GetComputerName (str,len); MessageBox.Show(System.Text.Encoding.ASCII.GetString(str)); 在有的例子用到了MashalAs特性，它用于描述字段、方法或参数的封送处理格式。用它作为参数前缀并指定目标需要的数据类型。例如，以下代码将两个参数作为数据类型长指针封送给 Windows API 函数的字符串 (LPStr)： [MarshalAs(UnmanagedType.LPStr)] 　　String existingfile; 　　[MarshalAs(UnmanagedType.LPStr)] 　　String newfile; 也许您有的时候会问，这些函数从哪里找呢，怎么知道某个DLL中有这什么函数呢。当然了，我们需要API帮助文件，这里我下了很多，有DEPHIL的，有VB的，还有英文版的，不过我还是比较喜欢英文版的，因为它里面的函数比较全。 这些帮助文档，你按照图片里的文件名在baidu或者google上就可以搜到，如果搜不到的话可以给我发邮件，我的邮箱：masky5310@126.com