C#调用VC编写的DLL传递字符串参数的正确方法

核心挑战：托管与非托管内存的桥梁

C#中的字符串是Unicode编码的托管对象，而传统的C/C++ DLL通常期望接收以空字符结尾的ANSI或UTF-8编码的非托管内存缓冲区（char*）。如果使用默认签名直接传递string，Marshaller可能无法正确处理多字节编码，导致乱码或内存访问违规。

第一步：准备非托管字符串转换辅助方法

为了实现精准的内存控制，我们需要编写一个辅助方法来处理从托管String到非托管IntPtr的转换。此方法需执行以下操作：

1. 获取字节数据：根据DLL的语言标准（通常是系统默认ANSI或UTF-8），将C#字符串转换为字节数组。
2. 分配非托管内存：使用 Marshal.AllocHGlobal 申请足够大小的堆内存，通常建议预留额外空间以防尾部截断。
3. 初始化内存：将申请的内存清零，防止残留数据干扰。
4. 复制数据：将转换后的字节数组拷贝至非托管内存区域。

private static IntPtr mallocIntptr( string strData )
{
    // 1. 将字符串转换为字节数组（此处使用默认编码，通常为ANSI）
    Byte[] btData = System.Text.Encoding.Default.GetBytes(strData);

    // 2. 申请非托管内存空间
    IntPtr m_ptr = Marshal.AllocHGlobal(btData.Length);

    // 3. 创建零字节数组并填充内存（增加1位确保有终止符，视具体函数要求而定）
    Byte[] btZero = new Byte[btData.Length + 1];
    Marshal.Copy(btZero, 0, m_ptr, btZero.Length);

    // 4. 将数据复制到非托管内存
    Marshal.Copy(btData, 0, m_ptr, btData.Length);

    return m_ptr;
}

第二步：定义正确的 P/Invoke 签名

在声明外部DLL函数时，必须将原本C语言中的 `char*` 参数映射为 C# 的 IntPtr。这强制调用者手动管理参数的生命周期和内存格式。

using System.Runtime.InteropServices;

[DllImport("Index_dll.dll", CallingConvention = CallingConvention.Cdecl)]
unsafe private static extern Int32 create_index_file(
    IntPtr filename, 
    IntPtr fieldname, 
    UInt32 tongshu, 
    IntPtr err
);

第三步：构建安全的调用封装

创建一个公共方法，负责内存的申请、错误信息的读取以及资源的清理。务必使用 try...finally 或 try...catch 结构，确保即使出错也能释放非托管内存，防止内存泄漏。

public static bool CreateIndexFile(string m_strFileName, string m_strFieldName, UInt32 m_key, ref string strErr)
{
    IntPtr ptrFileName = IntPtr.Zero;
    IntPtr ptrFieldName = IntPtr.Zero;
    IntPtr ptrErr = IntPtr.Zero;

    try
    {
        // 分配内存
        ptrFileName = mallocIntptr(m_strFileName);
        ptrFieldName = mallocIntptr(m_strFieldName);
        ptrErr = mallocIntptr(300); // 假设错误信息不超过300字符

        // 调用DLL
        int result = create_index_file(ptrFileName, ptrFieldName, m_key, ptrErr);

        if (result != 1) // 假设返回值为1表示成功
        {
            // 如果失败，尝试从输出指针中读取错误信息
            strErr = Marshal.PtrToStringAnsi(ptrErr);
            return false;
        }
        
        return true;
    }
    catch (System.Exception ex)
    {
        strErr = ex.Message;
        return false;
    }
    finally
    {
        // 确保内存被释放
        if (ptrFileName != IntPtr.Zero) Marshal.FreeHGlobal(ptrFileName);
        if (ptrFieldName != IntPtr.Zero) Marshal.FreeHGlobal(ptrFieldName);
        if (ptrErr != IntPtr.Zero) Marshal.FreeHGlobal(ptrErr);
    }
}

关键注意事项与排错

• 编码一致性：如果在VC端使用的是UTF-8编码，C#端必须使用 Encoding.UTF8.GetBytes()；如果是ANSI，使用 Encoding.Default。不匹配会导致中文乱码。
• 内存释放：Marshal.AllocHGlobal 分配的内存必须在非托管端释放或由同进程通过 FreeHGlobal 释放。切勿遗漏，否则会造成长期运行的程序内存耗尽。
• 返回值处理：如果DLL通过指针参数回传字符串（如上面的 err 指针），记得在调用后使用 Marshal.PtrToStringAnsi 或对应编码将其读回。

以上就是C#调用DLL传递字符串指针参数的详细内容，更多关于C# P/Invoke非托管内存管理的资料请关注本站其它相关文章！