C#中操作API

作为初学者来说,在C#中使用API确是一件令人头疼的问题。在使用API之间你必须知道如何在C#中使用结构、类型转换、安全/不安全代码,可控/不可控代码等许多知识。

一切从简单开始,复杂的大家一时不能接受。我们就从实现一个简单的MessageBox开始。首先打开VS.Net ,创建一个新的C#工程,并添加一个Button按钮。当这个按钮被点击,则显示一个MessageBox对话框。

即然我们需要引用外来库,所以必须导入一个Namespace:

using System.Runtime.InteropServices;

接着添加下面的代码来声明一个API:

[DllImport("User32.dll")] 
public static extern int MessageBox(int h, string m, string c, int type);

此处DllImport属性被用来从不可控代码中调用一方法。"User32.dll"则设定了类库名。DllImport属性指定dll的位置,这个dll中包括调用的外部方法。Static修饰符则声明一个静态元素,而这个元素属于类型本身而不是上面指定的对象。extern则表示这个方法将在工程外部执行,使用DllImport导入的方法必须使用extern修饰符。

MessageBox 则是函数名,拥有4个参数,其返回值为数字。

大多数的API都能传递并返回值。

添中Click点击事件代码:

protected void button1_Click(object sender, System.EventArgs e)
{
    MessageBox (0,"API Message Box","API Demo",0);
}

编译并运行这个程序,当你点击按钮后,你将会看到对话框,这便是你使用的API函数。

使用结构体

操作带有结构体的API比使用简单的API要复杂的多。但是一旦你掌握了API的过程,那个整个API世界将在你的掌握之中。

下面的例子中我们将使用GetSystemInfo API 来获取整个系统的信息。

第一步还是打开C#建立一个Form工程,同样的添中一个Button按钮,在代码窗中输入下面的代码,导入Namespace:

using System.Runtime.InteropServices;

声明一个结构体,它将做为GetSystemInfo的一个参数:

[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;
}

声明API函数:

[DllImport("kernel32")]
static extern void GetSystemInfo(ref SYSTEM_INFO pSI);

添加下面的代码至按钮的点击事件处理中:

首先创建一个SYSTEM_INFO结构体,并将其传递给GetSystemInfo函数。

protected void button1_Click (object sender, System.EventArgs e)
{
    try
    {
        SYSTEM_INFO pSI = new SYSTEM_INFO();
        GetSystemInfo(ref pSI);
        // 一旦你接收到返回的结构体,那么就可以以返回的参数来执行操作了。
        e.g.listBox1.InsertItem(0,pSI.dwActiveProcessorMask.ToString());
    }
    catch(Exception er)
    {
        MessageBox.Show(er.Message);
    }
}
//Created By Ajit Mungale
//程序补充 飞刀
namespace UsingAPI
{
    using System;
    using System.Drawing;
    using System.Collections;
    using System.ComponentModel;
    using System.WinForms;
    using System.Data;
    using System.Runtime.InteropServices;

    //Struct 收集系统信息 
    [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;
    }

    //struct 收集内存情况 
    [StructLayout(LayoutKind.Sequential)]
    public struct MEMORYSTATUS
    {
        public uint dwLength;
        public uint dwMemoryLoad;
        public uint dwTotalPhys;
        public uint dwAvailPhys;
        public uint dwTotalPageFile;
        public uint dwAvailPageFile;
        public uint dwTotalVirtual;
        public uint dwAvailVirtual;
    }

    public class Form1 : System.WinForms.Form
    {
        private System.ComponentModel.Container components;
        private System.WinForms.MenuItem menuAbout;
        private System.WinForms.MainMenu mainMenu1;
        private System.WinForms.ListBox listBox1;
        private System.WinForms.Button button1;

        //获取系统信息 
        [DllImport("kernel32")]
        static extern void GetSystemInfo(ref SYSTEM_INFO pSI);

        //获取内存信息 
        [DllImport("kernel32")]
        static extern void GlobalMemoryStatus(ref MEMORYSTATUS buf);

        //处理器类型 
        public const int PROCESSOR_INTEL_386 = 386;
        public const int PROCESSOR_INTEL_486 = 486;
        public const int PROCESSOR_INTEL_PENTIUM = 586;
        public const int PROCESSOR_MIPS_R4000 = 4000;
        public const int PROCESSOR_ALPHA_21064 = 21064;

        public Form1()
        {
            InitializeComponent();
        }

        public override void Dispose()
        {
            base.Dispose();
            components.Dispose();
        }

        private void InitializeComponent()
        {
            this.components = new System.ComponentModel.Container();
            this.mainMenu1 = new System.WinForms.MainMenu();
            this.button1 = new System.WinForms.Button();
            this.listBox1 = new System.WinForms.ListBox();
            this.menuAbout = new System.WinForms.MenuItem();
            mainMenu1.MenuItems.All = new System.WinForms.MenuItem[1] { this.menuAbout };
            button1.Location = new System.Drawing.Point(148, 168);
            button1.Size = new System.Drawing.Size(112, 32);
            button1.TabIndex = 0;
            button1.Text = "&Get Info";
            button1.Click += new System.EventHandler(this.button1_Click);
            listBox1.Location = new System.Drawing.Point(20, 8);
            listBox1.Size = new System.Drawing.Size(368, 147);
            listBox1.TabIndex = 1;
            menuAbout.Text = "&About";
            menuAbout.Index = 0;
            menuAbout.Click += new System.EventHandler(this.menuAbout_Click);
            this.Text = "System Information - Using API";
            this.MaximizeBox = false;
            this.AutoScaleBaseSize = new System.Drawing.Size(5, 13);
            this.MinimizeBox = false;
            this.Menu = this.mainMenu1;
            this.ClientSize = new System.Drawing.Size(408, 213);
            this.Controls.Add(this.listBox1);
            this.Controls.Add(this.button1);
        }

        protected void menuAbout_Click(object sender, System.EventArgs e)
        {
            Form abt = new about();
            abt.ShowDialog();
        }

        protected void button1_Click(object sender, System.EventArgs e)
        {
            try
            {
                SYSTEM_INFO pSI = new SYSTEM_INFO();
                GetSystemInfo(ref pSI);
                string CPUType;
                switch (pSI.dwProcessorType)
                {
                    case PROCESSOR_INTEL_386:
                        CPUType = "Intel 386";
                        break;
                    case PROCESSOR_INTEL_486:
                        CPUType = "Intel 486";
                        break;
                    case PROCESSOR_INTEL_PENTIUM:
                        CPUType = "Intel Pentium";
                        break;
                    case PROCESSOR_MIPS_R4000:
                        CPUType = "MIPS R4000";
                        break;
                    case PROCESSOR_ALPHA_21064:
                        CPUType = "DEC Alpha 21064";
                        break;
                    default:
                        CPUType = "(unknown)";
                }

                listBox1.InsertItem(0, "Active Processor Mask :" + pSI.dwActiveProcessorMask.ToString());
                listBox1.InsertItem(1, "Allocation Granularity :" + pSI.dwAllocationGranularity.ToString());
                listBox1.InsertItem(2, "Number Of Processors :" + pSI.dwNumberOfProcessors.ToString());
                listBox1.InsertItem(3, "OEM ID :" + pSI.dwOemId.ToString());
                listBox1.InsertItem(4, "Page Size:" + pSI.dwPageSize.ToString());
                listBox1.InsertItem(5, "Processor Level Value:" + pSI.dwProcessorLevel.ToString());
                listBox1.InsertItem(6, "Processor Revision:" + pSI.dwProcessorRevision.ToString());
                listBox1.InsertItem(7, "CPU type:" + CPUType);
                listBox1.InsertItem(8, "Maximum Application Address: " + pSI.lpMaximumApplicationAddress.ToString());
                listBox1.InsertItem(9, "Minimum Application Address:" + pSI.lpMinimumApplicationAddress.ToString());
                /************** 从 GlobalMemoryStatus 获取返回值****************/

                MEMORYSTATUS memSt = new MEMORYSTATUS();
                GlobalMemoryStatus(ref memSt);
                listBox1.InsertItem(10, "Available Page File :" + (memSt.dwAvailPageFile / 1024).ToString());
                listBox1.InsertItem(11, "Available Physical Memory : " + (memSt.dwAvailPhys / 1024).ToString());
                listBox1.InsertItem(12, "Available Virtual Memory:" + (memSt.dwAvailVirtual / 1024).ToString());
                listBox1.InsertItem(13, "Size of structur :" + memSt.dwLength.ToString());
                listBox1.InsertItem(14, "Memory In Use :" + memSt.dwMemoryLoad.ToString());
                listBox1.InsertItem(15, "Total Page Size :" + (memSt.dwTotalPageFile / 1024).ToString());
                listBox1.InsertItem(16, "Total Physical Memory :" + (memSt.dwTotalPhys / 1024).ToString());
                listBox1.InsertItem(17, "Total Virtual Memory :" + (memSt.dwTotalVirtual / 1024).ToString());
            }
            catch (Exception er)
            {
                MessageBox.Show(er.Message);
            }
        }

        public static void Main(string[] args)
        {
            try
            {
                Application.Run(new Form1());
            }

            catch (Exception er)
            {
                MessageBox.Show(er.Message);
            }
        }
    }
}
Contributors: FHL