Click here to Skip to main content
15,171,993 members
Articles / Programming Languages / C#
Posted 3 Aug 2001


125 bookmarked

Calling API functions using C#

Rate me:
Please Sign up or sign in to vote.
4.81/5 (41 votes)
10 Oct 20015 min read
This article helps you to get an idea about calling API functions in C#.

Sample Image - usingAPI.gif


An API (Application Programming Interface) is a set of commands, which interfaces the programs with the processors. The most commonly used set of external procedures are those that make up Microsoft Windows itself. The Windows API contains thousands of functions, structures, and constants that you can declare and use in your projects. Those functions are written in the C language, however, so they must be declared before you can use them. The declarations for DLL procedures can become fairly complex. Specifically to C# it is more complex than VB. You can use API viewer tool to get API function declaration but you have to keep in mind the type of parameter, which is different in C#.

Most of the advanced languages support API programming. The Microsoft Foundation Class Library (MFC) framework encapsulates a large portion of the Win32 (API). ODBC API Functions are useful for performing fast operations on database. With API your application can request lower-level services to perform on computer's operating system. As API supports thousands of pieces functionality from simple nessage boxes to encryption or remote computing; developers should know how to implement the API in their program.

APIs have many types depending on OS, processor and functionality.

OS specific API:

Each operating system has common set of API's and some special ones


Windows NT supports MS-DOS, Win16, Win32, POSIX (Portable Operating System Interface), OS/2 console API; and Windows 95 supports MS-DOS, Win16 and Win32 APIs.

Win16 & Win32 API:

Win16 is an API created for 16-bit processor and relies on 16 bit values. It has a platform independent nature.

e.g. you can tie Win16 programs to MS-DOS feature like TSR programs.

Win32 is an API created for 32-bit processor and relies on 32 bit values. It is portable to any operating system, a wide range of processors and is of a platform independent nature.

Win32 APIs has the '32' prefix after the library name e.g. KERNEL32, USER32 etc -

All APIs are implemented using 3 Libraries.

  • Kernel
  • User
  • GDI


It is the library named KERNEL32.DLL, which supports capabilities that are associated with the OS such as

  • Process loading.
  • Context switching.
  • File I/O.
  • Memory management.

e.g. The GlobalMemoryStatus function obtains information about the system's current usage of both physical and virtual memory


This is the library named USER32.DLL in Win32.

This allows managing the entire user interfaces, such as

  • Windows
  • Menus
  • Dialog Boxes
  • Icons etc.,

e.g. The DrawIcon function draws an icon or cursor into the specified device context.

3. GDI (Graphical Device Interface

This is the library named "GDI32.dll" in Win32. It is Graphic output library. Using GDI Windows draws windows, menus and dialog boxes.

  • It can create Graphical Output.
  • It can also use for storing graphical images.

e.g. The CreateBitmap function creates a bitmap with the specified width, height, and color format (color planes and bits-per-pixel).

C# and API:

Implementing APIs in C# is a tough job for beginners. Before implementing API you should know how to implement structure in C#, type conversion, safe/unsafe code, managed/unmanaged code and lots more.

Before implementing complex APIs we will start with simple MessageBox API. To implement code for the MessageBox API open a new C# project and add one button. When button gets clicked the code will display a Message Box.

Since we are using external library, add a namespace:

using System.Runtime.InteropServices;

Add the following lines to declare the API

public static extern int MessageBox(int h, string m, string c, int type);

Here the DllImport attribute is used for calling the method from unmanaged code. "User32.dll" indicates the library name. The DllImport attribute specifies the dll location that contains the implementation of an extern method. The static modifier is used to declare a static member, which belongs to the type itself rather than to a specific object, extern is used to indicate that the method is implemented externally. A method that is decorated with the DllImport attribute must have the extern modifier.

MessageBox is the function name, which returns int and takes 4 parameters as shown in declaration.

Many APIs use structures to pass and retrieve values, as it is less expensive. It also uses constant data type for passing constant data and simple data types for passing built-in data types as seen in the previous declaration of the MessageBox function.

Add following code for button click event:

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

Compile and run project, after clicking on the button you will see a MessageBox, which you called using API the function!!!

Using Structures

Working with APIs, which use complex structures, or structures inside structures, is somewhat more complex than using simple APIs. But once you understand the implementation then the whole API world is yours.

In next example we will use GetSystemInfo API which returns information about the current system.

The first step is open a new C# form and add one button on it. Go to the code window of the form and add a namespace:

using System.Runtime.InteropServices;

Declare the structure, which is the parameter of GetSystemInfo.

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;

Declare the API function:

static extern void GetSystemInfo(ref SYSTEM_INFO pSI); 

Where ref is next to the method parameter keyword it causes a method to refer to the same variable that was passed into the method.

Add the following code in the button click event in which we first create a struct object and then pass it to function.

protected void button1_Click (object sender, System.EventArgs e)
		GetSystemInfo(ref pSI);

Once you retrieve the structure, perform operations on the required parameter

e.g.listBox1.InsertItem (0,pSI.dwActiveProcessorMask.ToString());:

	catch(Exception er)
		MessageBox.Show (er.Message);

In the attached code I used two API's to retrieve various information from the system.


I used beta version 1.0 for creating sample application. In Beta 2, declaration of API functions may be slightly different than 1.0.


This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


About the Author

Ajit Mungale
Web Developer
United States United States
No Biography provided

Comments and Discussions

GeneralMy vote of 5 Pin
Bibekananda Jena25-Jul-13 14:50
MemberBibekananda Jena25-Jul-13 14:50 
QuestionC# API Pin
James Whyte10-Oct-12 0:03
MemberJames Whyte10-Oct-12 0:03 
GeneralMy vote of 5 Pin
Sunny_Kumar_30-Oct-11 22:35
MemberSunny_Kumar_30-Oct-11 22:35 
GeneralMy vote of 4 Pin
greendragons20-Oct-10 11:05
Membergreendragons20-Oct-10 11:05 
GeneralThank you very much! Pin
Mohammad Elsheimy24-May-10 11:59
MemberMohammad Elsheimy24-May-10 11:59 Pin
rmshKumar59-Aug-08 0:50
MemberrmshKumar59-Aug-08 0:50 
Generalchanging caption of a running application - plz help Pin
angelsherin22-Jun-08 1:35
Memberangelsherin22-Jun-08 1:35 
Generalchanging caption of a running application - plz help Pin
angelsherin22-Jun-08 1:34
Memberangelsherin22-Jun-08 1:34 
Generalchanging caption of a running application - plz help Pin
angelsherin22-Jun-08 1:34
Memberangelsherin22-Jun-08 1:34 
Generalproblem with Microsoft.Win32.Interop Pin
lang11-Jun-08 9:35
Memberlang11-Jun-08 9:35 
GeneralWin32 and C# Pin
Will230-Aug-07 6:34
MemberWill230-Aug-07 6:34 
Generalshutdown computer Pin
canhthu31-Mar-07 5:47
Membercanhthu31-Mar-07 5:47 
GeneralRe: shutdown computer Pin
Kristian Sixhøj17-Sep-07 8:30
MemberKristian Sixhøj17-Sep-07 8:30 
QuestionExitWindowEX function in Win32 API Pin
Mr. Ankur28-Mar-07 18:22
MemberMr. Ankur28-Mar-07 18:22 
AnswerRe: ExitWindowEX function in Win32 API Pin
Saiyed Alam25-May-07 6:09
MemberSaiyed Alam25-May-07 6:09 
GeneralAPI Call with lpString type Parameter Pin
tankSanju14-Dec-06 21:49
MembertankSanju14-Dec-06 21:49 
Generalhi, please give the useful list of API' for writting a serialport application. Pin
premkamalg27-Aug-06 22:03
Memberpremkamalg27-Aug-06 22:03 
QuestionRe: hi, please give the useful list of API' for writting a serialport application. Pin
dogmatic6931-Oct-07 1:03
Memberdogmatic6931-Oct-07 1:03 
GeneralCalling a function in Dll Pin
cuongcntt200212-Apr-06 9:16
Membercuongcntt200212-Apr-06 9:16 
GeneralRe: Calling a function in Dll Pin
leducson7-Jul-06 9:44
Memberleducson7-Jul-06 9:44 
GeneralAPI Viewer in C# Code Pin
Ariston Darmayuda29-Dec-05 8:14
MemberAriston Darmayuda29-Dec-05 8:14 
GeneralDataSource selector window Pin
oquesada6-Oct-05 9:01
Memberoquesada6-Oct-05 9:01 
QuestionHow to use Api to get information about HD Pin
kaszub25-May-05 23:20
Memberkaszub25-May-05 23:20 
QuestionHow to call ODBC API SQLSetConnectAttr in C# Pin
edmondkc2-Jun-04 22:52
Memberedmondkc2-Jun-04 22:52 
Generalusing API example Pin
has1sir28-Apr-04 22:39
Memberhas1sir28-Apr-04 22:39 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.