C#程序实现动态调用非托管的DLL文件

C#程序实现动态调用非托管的DLL文件

一.Dll文件  

动态链接库（也称为DLL，即为“Dynamic Link Library”的缩写）是Microsoft Windows最重要的组成要素之一，打开Windows系统文件夹，你会发现文件夹中有很多DLL文件，Windows就是将一些主要的系统功能以DLL模块的形式实现。

动态链接库是不能直接执行的，也不能接收消息，它只是一个独立的文件，其中包含能被程序或其它DLL调用来完成一定操作的函数(方法。注：C#中一般称为“方法”)，但这些函数不是执行程序本身的一部分，而是根据进程的需要按需载入，此时才能发挥作用。

DLL只有在应用程序需要时才被系统加载到进程的虚拟空间中，成为调用进程的一部分，此时该DLL也只能被该进程的线程访问，它的句柄可以被调用进程所使用，而调用进程的句柄也可以被该DLL所使用。在内存中，一个DLL只有一个实例，且它的编制与具体的编程语言和编译器都没有关系，所以可以通过DLL来实现混合语言编程。DLL函数中的代码所创建的任何对象（包括变量）都归调用它的线程或进程所有。

二、      DLL的调用

每种编程语言调用DLL的方法都不尽相同，在此只对用C#调用DLL的方法进行介绍。首先,您需要了解什么是托管,什么是非托管。一般可以认为：非托管代码主要是基于win 32平台开发的DLL，activeX的组件，托管代码是基于.net平台开发的。如果您想深入了解托管与非托管的关系与区别，及它们的运行机制，请您自行查找资料，本文件在此不作讨论。

(一)     调用DLL中的非托管函数一般方法

首先，应该在C#语言源程序中声明外部方法，其基本形式是：

[DLLImport(“DLL文件”)]

修饰符 extern 返回变量类型 方法名称 （参数列表）

其中：

DLL文件：包含定义外部方法的库文件。

修饰符： 访问修饰符，除了abstract以外在声明方法时可以使用的修饰符。

返回变量类型：在DLL文件中你需调用方法的返回变量类型。

方法名称：在DLL文件中你需调用方法的名称。

参数列表：在DLL文件中你需调用方法的列表。

注意：需要在程序声明中使用System.Runtime.InteropServices命名空间。

      DllImport只能放置在方法声明上。

DLL文件必须位于程序当前目录或系统定义的查询路径中（即：系统环境变量中Path所设置的路径）。

返回变量类型、方法名称、参数列表一定要与DLL文件中的定义相一致。

若要使用其它函数名，可以使用EntryPoint属性设置，如：

[DllImport("user32.dll", EntryPoint="MessageBoxA")]

static extern int MsgBox(int hWnd, string msg, string caption, int type);

其它可选的 DllImportAttribute 属性：

CharSet 指示用在入口点中的字符集，如：CharSet=CharSet.Ansi；

SetLastError 指示方法是否保留 Win32"上一错误"，如：SetLastError=true；

ExactSpelling 指示 EntryPoint 是否必须与指示的入口点的拼写完全匹配，如：ExactSpelling=false；

PreserveSig指示方法的签名应当被保留还是被转换， 如：PreserveSig=true；

CallingConvention指示入口点的调用约定， 如：CallingConvention=CallingConvention.Winapi；

以下是实例代码：

/// <returns> 0，成功；200，连接加密机失败；201，取随机数1 失败；202，取随机数2 失败；203，密钥分散失败；204，数据加密失败；205，取密文失败</returns>
  [System.Runtime.InteropServices.DllImport("TestZhuzhan.dll",CharSet=CharSet.Auto)]
        public static extern int IdentityAuthentication([MarshalAs(UnmanagedType.LPStr)] StringBuilder sDiv, [MarshalAs(UnmanagedType.LPStr)] StringBuilder RandAndEndata);

  /// <summary>
  /// 名称：2．远程控制函数
  /// 功能：远程控制
  /// </summary>
  /// <param name="RandDivEsamNumData">输入参数，字符型，4 字节随机数 +8字节分散因子+8字节ESAM序列号+数据明文。</param>
  /// <param name="dataOut">字符型，20 字节密文</param>
  /// <returns> 0，成功；200，连接加密机失败；201，写卡失败；202，读卡失败；203，计算密文失败；</returns>
  [System.Runtime.InteropServices.DllImport("TestZhuzhan.dll",CharSet=CharSet.Auto)]
  public static extern int UserControl([MarshalAs(UnmanagedType.LPStr)] StringBuilder RandDivEsamNumData,[MarshalAs(UnmanagedType.LPStr)] StringBuilder dataOut);

  /// <summary>
  /// 名称：3.充值函数
  /// 功能：钱包充值
  /// </summary>
  /// <param name="RandDivData">字符型 4 字节随机数；8 字节分散因子；电量和次数，8 字节；首次充值时，6 字节户号。</param>
  /// <param name="dataout">返回电量，次数和4 字节MAC。</param>
  /// <returns> 0，成功；200，连接加密机失败；201，写卡失败；202，读卡失败；203，计算MAC 失败；</returns>
  [System.Runtime.InteropServices.DllImport("TestZhuzhan.dll",CharSet=CharSet.Auto)]
  unsafe public static extern int InCreasePurse([MarshalAs(UnmanagedType.LPStr)] StringBuilder RandDivData,[MarshalAs(UnmanagedType.LPStr)] StringBuilder dataout);

  /// <summary>
  /// 名称：4．参数更新函数
  /// 功能：更新参数
  /// </summary>
  /// <param name="RandDivApduData">4 字节随机数；8 字节分散因子；更新指令 10 位(04d682+起始+LC)；LC=明文数据长度+4。其他为参数明文。</param>
  /// <param name="dataout">返回参数明文和MAC。</param>
  /// <returns> 0，成功；200，连接加密机失败；201，写卡失败；202，读卡失败；203，计算MAC 失败；</returns>
  [System.Runtime.InteropServices.DllImport("TestZhuzhan.dll",CharSet=CharSet.Auto)]
  public static extern int ParameterUpdate([MarshalAs(UnmanagedType.LPStr)] StringBuilder RandDivApduData,[MarshalAs(UnmanagedType.LPStr)] StringBuilder dataout);

  /// <summary>
  /// 名称：5．密文+MAC 参数更新函数
  /// 功能：密文+MAC 更新参数
  /// </summary>
  /// <param name="RandDivApduData">4 字节随机数；8 字节分散因子；更新指令 10 位(04d6+文件标识+00+LC)；
  ///                                （此处 LC 长度为下发密文数据+MAC 的长度）,其他为参数明文</param>
  /// <param name="EsamNum">输入参数，8 字节ESAM 序列号。</param>
  /// <param name="dataout">返回参数密文和MAC。电能表接收密文+MAC 后，用04d6+文件标识+00+LC+密文+MAC 更新ESAM 文件，
  ///                         然后明文读取数据，该文件第一个字节为明文 数据的长度（HEX），可以根据该长度取所解密后的明文。</param>
  /// <returns> 0，成功；200，连接加密机失败；201，写卡失败；202，读卡失败；203，计算MAC 失败；</returns>
  [System.Runtime.InteropServices.DllImport("TestZhuzhan.dll",CharSet=CharSet.Auto)]
  public static extern int ParameterElseUpdate([MarshalAs(UnmanagedType.LPStr)] StringBuilder RandDivApduData,[MarshalAs(UnmanagedType.LPStr)] StringBuilder EsamNum,[MarshalAs(UnmanagedType.LPStr)] StringBuilder dataout);

  /// <summary>
  /// 名称：6．密钥更新函数
  /// 功能：更新密钥
  /// </summary>
  /// <param name="kid">整型，kid=1，身份认证密钥；kid=2,远程控制密钥；Kid=3,参数更新密钥。</param>
  /// <param name="DivEsamNumRandData">输入参数，字符型，8 字节分散因子+8字节ESAM序列号+4字节随机数+4字节 数据明文。</param>
  /// <param name="dataOut">返回32 字节密文+ 4 字节密钥信息+4 字节MAC。</param>
  /// <returns> 0，成功；200，连接加密机失败；201，写卡失败；202，读卡失败；203，计算MAC 失败；</returns>
  [System.Runtime.InteropServices.DllImport("TestZhuzhan.dll",CharSet=CharSet.Auto)]
  public static extern int KeyUpdate(int kid ,[MarshalAs(UnmanagedType.LPStr)] StringBuilder DivEsamNumRandData,[MarshalAs(UnmanagedType.LPStr)] StringBuilder dataOut);

  /// <summary>
  /// 名称：7．校验MAC 函数
  /// 功能：校验 MAC
  /// </summary>
  /// <param name="RandDivData">输入参数,4 字节随机数+8 字节分散因子+5字节指令(04d68600+LC)+数据明文+4 字节 MAC。LC=明文长度+0x0C；</param>
  /// <param name="dataout">空</param>
  /// <returns> 0，成功；其他 MAC 错；</returns>
  [System.Runtime.InteropServices.DllImport("TestZhuzhan.dll",CharSet=CharSet.Auto)]
  public static extern int Maccheck([MarshalAs(UnmanagedType.LPStr)] StringBuilder RandDivData,[MarshalAs(UnmanagedType.LPStr)] StringBuilder dataout);

  /// <summary>
  /// 名称：8．费率文件1 更新函数
  /// 功能：更新参数
  /// </summary>
  /// <param name="RandDivApduData">随机数 8 位；分散因子 16 位；更新指令 10 位(04d683+起始+LC)； LC=明文数据长度+4。其他为参数明文。</param>
  /// <param name="dataOut">返回参数明文和MAC。</param>
  /// <returns> 0，成功；200，连接加密机失败；201，写卡失败；202，读卡失败；203，计算MAC 失败；</returns>
  [System.Runtime.InteropServices.DllImport("TestZhuzhan.dll",CharSet=CharSet.Auto)]
  public static extern int Parameter1([MarshalAs(UnmanagedType.LPStr)] StringBuilder RandDivApduData,[MarshalAs(UnmanagedType.LPStr)] StringBuilder dataout);

  /// <summary>
  /// 名称：9．费率文件2 更新函数
  /// 功能：更新参数
  /// </summary>
  /// <param name="RandDivApduData">随机数 8 位；分散因子 16 位；更新指令 10 位(04d684+起始+LC)； LC=明文数据长度+4。其他为参数明文。</param>
  /// <param name="dataOut">返回参数明文和MAC。</param>
  /// <returns> 0，成功；200，连接加密机失败；201，写卡失败；202，读卡失败；203，计算MAC 失败；</returns>
  [System.Runtime.InteropServices.DllImport("TestZhuzhan.dll",CharSet=CharSet.Auto)]
  public static extern int Parameter2([MarshalAs(UnmanagedType.LPStr)] StringBuilder RandDivApduData,[MarshalAs(UnmanagedType.LPStr)] StringBuilder dataout);