C# 与 C 类型对照速查表

C# 与 C 类型对照速查表

一、基础数值类型（无符号 / 有符号整数）

特殊常量对照

• INVALID_FILE_ATTRIBUTES = (DWORD)-1→ C#public const uint INVALID_FILE_ATTRIBUTES = 0xFFFFFFFF;
• INVALID_HANDLE_VALUE = (HANDLE)-1→ C#IntPtr(-1)

二、句柄、指针类（内核对象 / 内存地址）

关键规则

1. 所有句柄统一用IntPtr，不用int/uint（64 位程序地址会溢出）；
2. 无效句柄判断：if (h == IntPtr.Zero || h == (IntPtr)(-1))。

三、字符串类型（ANSI / Unicode 宽字符，重点易错）

重点说明

1. 输入字符串：单纯传入路径 / 文本用string；
2. 输出字符串（API 填充缓冲区）不能用 string，必须StringBuilder； 例：GetModuleFileNameW、GetWindowTextW；
3. GetProcAddress 函数名参数是 ANSI：[DllImport(..., CharSet.Ansi)]。

四、布尔类型

五、函数指针 / 回调（DLL 动态调用、窗口回调）

C 写法

typedef int (WINAPI *MsgBoxPtr)(HWND hWnd, LPCWSTR txt, LPCWSTR cap, UINT type);

C# 对应规则

1. 用delegate定义；
2. 必须加特性[UnmanagedFunctionPointer(CallingConvention.StdCall)]；
3. Windows API 统一StdCall调用约定，漏写会栈崩溃。

表格

C#

[UnmanagedFunctionPointer(CallingConvention.StdCall)] public delegate int DlgMsgBox(IntPtr hWnd, string text, string cap, uint type);

C#

IntPtr pFunc = GetProcAddress(hMod, "MessageBoxW"); DlgMsgBox fn = Marshal.GetDelegateForFunctionPointer<DlgMsgBox>(pFunc);

六、结构体 / 联合体（Windows 常用大结构）

通用映射规则

1. C# 结构体加[StructLayout(LayoutKind.Sequential)]保持内存顺序；
2. 有指针 / 句柄成员一律用IntPtr；
3. 字符数组缓冲区用fixed byte[]或StringBuilder；

LARGE_INTEGER 简化对照（最常用）

C：

typedef union _LARGE_INTEGER { struct { DWORD LowPart; LONG HighPart; }; LONGLONG QuadPart; } LARGE_INTEGER;

C# 直接简化：

// GetFileSizeEx 直接传 out long 替代结构体 [DllImport("kernel32.dll")] public static extern bool GetFileSizeEx(IntPtr hFile, out long lpFileSize);

七、指针输出参数（带 LP 前缀，输出值）

C 原型：BOOL GetXXX(DWORD* outValue);

c

BOOL GetDiskFreeSpaceEx(LPCWSTR path, ULARGE_INTEGER* avail, ULARGE_INTEGER* total, ULARGE_INTEGER* free);

C#：

[DllImport("kernel32.dll", CharSet = CharSet.Unicode)] public static extern bool GetDiskFreeSpaceEx(string path, out long avail, out long total, out long free);

八、调用约定对照表

九、高频易错坑总结

1. DWORD 不要用 int：无符号数值，超过 21 亿会溢出；统一 uint；
2. 句柄禁止用 int/long：64 位程序地址超 32 位，必须 IntPtr；
3. 输出字符串不用 string，只用 StringBuilder；
4. 宽字符 API 统一CharSet.Unicode，解决中文路径乱码；
5. 函数指针委托必须指定 StdCall，否则程序直接崩溃；
6. 结构体不加 Sequential 会内存对齐错乱，读取数据错误；
7. LoadLibrary / CreateFile 路径传中文，必须 W 版本 + Unicode 字符集。

C# 使用[DllImport]引入原生 Win32 API，分宽字符 W 版本（推荐，支持中文路径）

一、基础知识点

1. [DllImport("kernel32.dll")]：从系统内核库导入 API
2. CharSet = CharSet.Unicode= 调用 xxxW 宽字符版本，避免中文乱码
3. StringBuilder作为输出字符串缓冲区（C# string 不可修改，不能当输出参数）
4. IntPtr对应 C/C++ 里HMODULE / HANDLE / void*

1. GetModuleFileNameW C# 实现（获取程序自身路径）

using System; using System.Text; using System.Runtime.InteropServices; class Win32Helper { // 导入API [DllImport("kernel32.dll", CharSet = CharSet.Unicode)] public static extern uint GetModuleFileNameW( IntPtr hModule, // NULL=0 取当前EXE StringBuilder lpFilename, uint nSize ); static void Main() { StringBuilder sbPath = new StringBuilder(1024); uint ret = GetModuleFileNameW(IntPtr.Zero, sbPath, (uint)sbPath.Capacity); if (ret > 0) { Console.WriteLine("程序完整路径：" + sbPath.ToString()); // 截取目录（去掉exe文件名） string dir = System.IO.Path.GetDirectoryName(sbPath.ToString()); Console.WriteLine("程序目录：" + dir); } else { Console.WriteLine("获取失败"); } Console.ReadKey(); } }

2. LoadLibraryW + GetProcAddress + FreeLibrary C# 动态调用 DLL

模拟 C 里动态加载 user32 调用 MessageBoxW

using System; using System.Runtime.InteropServices; class DllInvokeDemo { // 1. 加载释放DLL [DllImport("kernel32.dll", CharSet = CharSet.Unicode)] public static extern IntPtr LoadLibraryW(string lpLibFileName); [DllImport("kernel32.dll", CharSet = CharSet.Ansi)] // 函数名是ASCII public static extern IntPtr GetProcAddress(IntPtr hModule, string lpProcName); [DllImport("kernel32.dll")] public static extern bool FreeLibrary(IntPtr hModule); // 2. 定义MessageBoxW委托（对应C函数指针） [UnmanagedFunctionPointer(CallingConvention.StdCall)] public delegate int DlgMsgBox(IntPtr hWnd, string text, string caption, uint type); static void Main() { // 加载user32.dll IntPtr hUser32 = LoadLibraryW("user32.dll"); if (hUser32 == IntPtr.Zero) { Console.WriteLine("加载DLL失败"); return; } // 获取MessageBoxW地址 IntPtr pMsgBox = GetProcAddress(hUser32, "MessageBoxW"); if (pMsgBox == IntPtr.Zero) { FreeLibrary(hUser32); return; } // 转为委托调用 DlgMsgBox msgBox = Marshal.GetDelegateForFunctionPointer<DlgMsgBox>(pMsgBox); msgBox(IntPtr.Zero, "C#调用Win32 API弹窗", "提示", 0); // 释放库 FreeLibrary(hUser32); Console.ReadKey(); } }

3. 常用配套 API 补充（GetFileAttributesW / INVALID_FILE_ATTRIBUTES）

public const uint INVALID_FILE_ATTRIBUTES = 0xFFFFFFFF; [DllImport("kernel32.dll", CharSet = CharSet.Unicode)] public static extern uint GetFileAttributesW(string lpFileName); // 使用 uint attr = GetFileAttributesW(@"D:\test.txt"); if (attr == INVALID_FILE_ATTRIBUTES) { Console.WriteLine("文件不存在/无法访问"); } else { bool isHidden = (attr & 2) != 0; // FILE_ATTRIBUTE_HIDDEN = 2 Console.WriteLine("是否隐藏：" + isHidden); }

关键注意事项

1. CharSet.Unicode 必须加不加默认 Ansi，中文路径、中文参数会乱码。
2. 输出字符串不能用string，必须StringBuilder原生 API 要改写缓冲区，string 是只读。
3. 函数名参数GetProcAddress传 ANSI 字符串 导出函数名字符串固定 ASCII，所以[DllImport]写CharSet.Ansi。
4. 委托必须标记[UnmanagedFunctionPointer(CallingConvention.StdCall)]Windows API 统一__stdcall 调用约定，漏写会栈失衡崩溃。
5. 资源释放LoadLibrary后必须FreeLibrary，避免内存泄漏。

4. C# 与 C 类型对照速查表