DllImport需严格匹配Windows API签名:函数名(含A/W后缀)、CallingConvention.Winapi、CharSet(Unicode优先)、StructLayout及字段对齐;字符串用StringBuilder或MarshalAs(LPWStr),结构体用Marshal.SizeOf验证大小;句柄须用SafeHandle封装。
DllImport特性怎么写才不会报错
关键不是“能不能调”,而是DllImport的参数是否匹配Windows API的实际签名。常见错误是函数名拼错、调用约定不一致、字符集没指定——比如调用MessageBoxA却没设CharSet = CharSet.Ansi,或调用GetSystemMetrics时漏了CallingConvention = CallingConvention.Winapi。
实操建议:
- 优先查MSDN原文,确认函数名(注意A/W后缀)、参数类型(如
int对应C的INT,但BOOL必须映射为bool或int)、返回值 - Windows API默认使用
StdCall,所以CallingConvention一般填CallingConvention.Winapi(它等价于StdCall) - 字符串参数务必显式指定
CharSet;多数现代API推荐用CharSet.Unicode,对应W版本函数(如MessageBoxW) - 结构体传参前加
[StructLayout(LayoutKind.Sequential)],字段对齐按C端要求设Pack
如何安全传递字符串和结构体到Win32函数
字符串容易出问题:C#的string是托管对象,直接传给API可能被GC移动或释放。结构体若字段顺序/大小不匹配,会导致读写越界或静默错误。
实操建议:
- 字符串用
MarshalAs(UnmanagedType.LPWStr)标注,配合CharSet = CharSet.Unicode,让P/Invoke自动做UTF-16转换和内存固定 - 避免用
ref string或out string接收API输出的字符串;改用StringBuilder并预分配足够容量(如new StringBuilder(260)) - 结构体中含指针字段(如
LPVOID)时,用IntPtr代替,再手动Marshal.PtrToStructure解析 - 用
Marshal.SizeOf()验证结构体大小是否与C头文件一致,尤其注意bool在C里是1字节,但C#默认按4字节打包
常见错误信息对应的修复点
运行时报System.EntryPointNotFoundException,说明函数找不到;报System.AccessViolationException,大概率是内存布局错或指针越界;而Attempted to read or write protected memory基本等于结构体字段没对齐或字符串没正确封送。