dotNET C# Programmer’s Guide to the Win32 API (Win32 API 声明C#版)
小气的神 2001.09.07
噢,对不起我用了这个标题,事实上如果我能做到10%,我就很高兴了。因为我的桌上正放着一本Dan Appleman的书,它曾伴随我许多年,也许你也有一本:1215页,蓝色书皮,机械工业出版社。英文名叫:《 Dan Appleman’s Visual Basic 5.0 Programmer’s Guide to the Win32 API 》。而我除了借用这个类似的名字之外,只是做了一下整理工作,不过这是一个不小的工作量(haha)
我把KERNEL32.DLL、USER32.DLL、GDI32.DLL、 ADVAPI32.DLL、SHELL32.DLL、SPOOLSS.DLL、WINMM.DLL的函数和声明整理了一下,改用C#的语法重新改写了一遍,整理出一个C#版本。这样针对dotNET的Platform Invocation Services(PInVoke),你就可以直接使用这些Win32的API函数了。目前MS没有公布整个的Win32API有多少可以在dotNET中使用,有多少不行。有些功能在dotNET中没有对应的实现,那么目前你可能还需要使用Win32的API函数。
结构和枚举声明放在一起,Kernel32.dll、User32.Dll、GDI32.dll分别放在3个cs文件中;剩下的Advapi32.dll、Shell32.dll、Spoolss.dll、Winmm.dll四个DLL的函数放在一个cs文件中,整个的namespace 起名叫Win32API.大致的构架应该象下面这样:
namespace Win32API {
using System;
using System.Runtime.InteropServices;
先是所有的结构和枚举声明
class Kernel32 {….}
class User32 {….}
class GDI32 {….}
class Advapi32 {….}
class Shell32 {….}
class Spoolss {….}
class Winmm {….}
}
对应的生成下面的C#文件:
Structs.NET.cs
Kernel32.NET.cs
User32.NET.cs
GDI32.NET.cs
OtherFnc.NET.cs
然后编译它们,这样就可以使用它们了,我没有计算5个文件包括的所有的准确个数,不过应该有百个结构和枚举,上千个函数声明吧。完成这些之后,现在最常用的MessageBox我可以这样使用了:
using System ;
using Win32API;
public class TestWin32API
{
public static void Main()
{
int iRet ;
iRet = User32.MessageBox( 0, "Hello C# Win32 API" , "My Pinvoke", 0 ) ;
}
}
就在测试这个例子时发生了一件有趣的事,因为刚开始我的cs文件都没有加NET的标识这样很自然的就有了Kernel32.cs、 User32.cs等等,MessageBox是User32.DLL中的,而我编译的User32.cs默认生成的也叫User32.DLL,当我执行这个测试程序时终于发生错误,我一直以为自己的声明有问题,然后我用FrameworkSDK中的例子也还是出错,直到我在其它的目录中运行正常时,我才发现原来自己的DLL名和系统的DLL名完全一样。然后就改成上面的那样,不过很奇怪csc /t:exe /r:User32.dll TestWin32API.cs 的编译指令居然没有错误提示,真是可恶。提醒你不要也象我一样。
恶梦也许还在后面,我还不知道真正的cs声明中又有多少个错误,反正用到的时候再调试吧。因为太多了所以不可能全都测试,也不敢一个个的测试,只希望自己这些整理能起到抛砖引玉的作用,如果以后你有新的版本,不要忘了Mail一份给我。
附带的Zip包中有所有cs的源码,我在Framework SDK Beta2 下都编译通过。
Windows 2000 ADV Server SP2 EN
Visual C# Compiler Version 7.00.9254
CLR version v1.0.2914
你可以根据你的情况进行编译(要先编译Structs.NET.cs,因为其它的都要/r:Structs.NET.DLL)或者使用二进制的DLL。dotnet的编译技术很好,5个DLL加起来才100多K。
下面是一下源码的节选:
--------------------------------------------------------------------------------
// Write by ccBoy
// Date: 2001.09.07
// csc /t:library /r:System.dll Structs.NET.cs
// csc /t:library /r:Structs.NET.dll Kernel32.NET.cs
// Emeditor 3.14
namespace Win32API {
using System;
using System.Runtime.InteropServices;
[StructLayout (LayoutKind.Sequential)]
public class ABC {
public int abcA;
public int abcB;
public int abcC;
}
[StructLayout (LayoutKind.Sequential)]
public class ABCFLOAT {
public float abcfA;
public float abcfB;
public float abcfC;
}
public Class Kerne
……