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);