C# Windows API介绍与调用
Windows API介紹:
????????Windows API 就是 windows應用程序接口,是針對microsoft windows操作系統家族的系統編程接口。
API函數分類:
1.基礎服務(Base Services)
? 提供對Windows系統可用的基礎資源的訪問接口。比如象:文件系統(file system)、外部設備(device)、,進程(process)、線程(thread)以及訪問注冊表(Windows registry)和錯誤處理機制(error handling)。這些功能接口位于,16位Windows下的kernel.exe、krnl286.exe或krnl386.exe系統文檔中;以及32位Windows下的 kernel32.dll和advapi32.dll中。
2.圖形設備接口(GDI)
? 提供功能為:輸出圖形內容到顯示器、打印機以及其他外部輸出設備。它位于16位Windows下的gdi.exe;以及32位Windows下的gdi32.dll。
3.圖形化用戶界面(GUI)
? 提供的功能有創建和管理屏幕和大多數基本控件(control),比如按鈕和滾動條。接收鼠標和鍵盤輸入,以及其他與GUI有關的功能。這些調用接口位于:16位Windows下的user.exe,以及32位Windows下的user32.dll。從Windows XP版本之后,基本控件和通用對話框控件(Common Control Library)的調用接口放在comctl32.dll中。
4.通用對話框鏈接庫(Common Dialog Box Library)
? 為應用程序提供標準對話框,比如打開/保存文檔對話框、顏色對話框和字體對話框等等。這個鏈接庫位于:16位Windows下的commdlg.dll中,以及32位Windows下comdlg32.dll中。它被歸類為User Interface API之下。
5.通用控件鏈接庫(Common Control Library)
? 為應用程序提供接口來訪問操作系統提供的一些高級控件。比如像:狀態欄(status bar)、進度條(progress bars)、工具欄(toolbar)和標簽(tab)。這個鏈接庫位于:16位Windows下的commctrl.dll中,以及32位Windows下comctl32.dll中。。它被歸類為User Interface API之下。
6.Windows外殼(Windows Shell)
? 作為Windows API的組成部分,不僅允許應用程序訪問Windows外殼提供的功能,還對之有所改進和增強。它位于16位Windows下的shell.dll中,以及32位Windows下的shell32.dll中(Windows 95則在 shlwapi.dll中)。 它被歸類為User Interface API之下。
7.網絡服務(Network Services)
? 為訪問操作系統提供的多種網絡 功能提供接口。它包括NetBIOS、Winsock、NetDDE及RPC等。
C#調用windows API通常有2種方法:
非托管方法: 直接調用從 DLL 導出的函數
托管方法:調用 COM 對象上的接口方法(如添加office引用Microsoft.Office.Interop.Word)
調用格式:
using System.Runtime.InteropServices; //引用此名稱空間,簡化后面的代碼 ... //使用DllImportAttribute特性來引入api函數,注意聲明的是空方法,即方法體為空。 [DllImport("user32.dll")] public static extern ReturnType FunctionName(type arg1,type arg2,...); //調用時與調用其他方法并無區別,可以使用字段進一步說明特性,用逗號隔開,如: [ DllImport( "kernel32", EntryPoint="GetVersionEx" )]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 來檢索錯誤代碼。
二、參數類型:
1、數值型直接用對應的就可。(DWORD -> int , WORD -> Int16)
2、API中字符串指針類型 -> .net中string
3、API中句柄 (dWord) ?-> .net中IntPtr
4、API中結構 ? -> .net中結構或者類。注意這種情況下,要先用StructLayout特性限定聲明結構或類
公共語言運行庫利用StructLayoutAttribute控制類或結構的數據字段在托管內存中的物理布局,即類或結構需要按某種方式排列。如果要將類傳遞給需要指定布局的非托管代碼,則顯式控制類布局是重要的。它的構造函數中用LayoutKind值初始化 StructLayoutAttribute 類的新實例。 LayoutKind.Sequential 用于強制將成員按其出現的順序進行順序布局。
LayoutKind.Explicit 用于控制每個數據成員的精確位置。利用 Explicit, 每個成員必須使用 FieldOffsetAttribute 指示此字段在類型中的位置。如:
參考:
https://www.jb51.net/article/46041.htm
Windows API 參考手冊
https://blog.csdn.net/joycesunny/article/details/91373963
總結
以上是生活随笔為你收集整理的C# Windows API介绍与调用的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 云栖科技评论第63期:有了AI,世界杯更
- 下一篇: DXP出现Un-Routed Net C