C# 调用 Windows API 教程

"C# API调用教程文档包含了关于如何在C#中调用Windows API的知识。文档中提到了使用DllImport特性来导入API函数，并详细解释了如何设置不同的属性以适应不同字符集和调用约定。" 在C#编程中，有时我们需要调用Windows操作系统提供的API函数来实现一些特定功能，这些功能可能不在.NET Framework的标准库中提供。C#通过`System.Runtime.InteropServices`命名空间中的`DllImport`特性使得开发者能够直接调用这些API函数。 首先，`DllImport`特性用于指示C#代码中的方法是通过动态链接库（DLL）导出的函数。例如，调用`MessageBox`函数，这个函数在`user32.dll`库中，我们可以这样定义： ```csharp using System.Runtime.InteropServices; public class Win32 { [DllImport("user32.dll", EntryPoint = "MessageBox")] public static extern int MsgBox(int hWnd, string text, string caption, uint type); } ``` 这里的`EntryPoint`属性用于指定在DLL中函数的实际入口点名称，因为有些API函数可能有多个版本，如ANSI和Unicode。`CharSet`属性则用来指定字符集，例如`CharSet.Unicode`表示使用Unicode字符集，`CharSet.Ansi`则表示使用ANSI字符集。`SetLastError`用于设置是否允许API函数修改最后一个错误代码，`ExactSpelling`则是指明函数名是否需要精确匹配，包括大小写。 当涉及到不同的字符集时，比如`MessageBoxA`和`MessageBoxW`，它们分别对应ANSI和Unicode版本的`MessageBox`函数。在C#中，通常推荐使用Unicode，因为它是.NET Framework的默认字符集，更符合现代编程的需求。如果API函数只有ANSI版本，可以设置`CharSet`为`CharSet.Ansi`，并可能需要指定`EntryPoint`以调用正确的函数。 此外，`CallingConvention`属性定义了函数调用约定，常见的有`StdCall`（默认Windows API使用）和`Cdecl`。`StdCall`约定中，参数由被调用者清理，而`Cdecl`则由调用者负责清理。 `MoveFile`函数的示例展示了如何处理包含宽字符的API函数，这里使用了`CharSet.Unicode`和`EntryPoint`来指定`MoveFileW`函数： ```csharp [DllImport("KERNEL32.DLL", EntryPoint = "MoveFileW", SetLastError = true, CharSet = CharSet.Unicode, ExactSpelling = true, CallingConvention = CallingConvention.StdCall)] public static extern bool MoveFile(string src, string dst); ``` 最后，API调用的错误处理通常通过检查返回值或使用`Marshal.GetLastWin32Error`方法获取错误代码来实现。如果API函数返回`false`，通常意味着调用失败，可以通过错误代码找出问题所在。 总结起来，C# API调用的关键点包括使用`DllImport`特性、设置正确参数、字符集选择以及错误处理。了解这些知识，开发者就能在C#程序中灵活地调用Windows API，扩展其功能。