使用.NE平台调用服务访问非托管 DLL 中的函数

使用.NET平台调用服务访问非托管 DLL 中的函数

概述：描述在Microsoft.Net框架下使用Win32API的方法。

关键字：平台调用，Invoke，DllImport。

一．背景

最近公司在做一个面向电信小灵通用户的SP信息服务软件，其中需要和省电信公司的短信网关通信，对方提供了一个开发包SmGwAPI.DLL（win32动态链接库）和一些文档，由于实在不想使用VC或DEPHI来开发该项目，所以最终决定使用dotNET平台调用技术来使用该API。

二．准备知识

先了解一下Win32动态链接库在VC里是如何定义的：

extern "C"  __declspec(dllexport)  int Validate(const char *);

       extern "C" 表示生成的DLL中的函数名称与定义时一致，否则就会生成形如

?MyMessage@@YAHPBDZ@Z 类似的函数名称。

导入上面的函数：

using System.Runtime.InteropServices;

[DllImport("Register.dll")]

public extern static int Validate(string str1);

导入系统函数：

using System.Runtime.InteropServices;

[DllImport("user32.dll")]

public static extern int MessageBox(int hWnd, String text, String caption, uint type);

三．平台调用

1.      DllImport

先看一个示例：

[DllImport("KERNEL32.DLL", EntryPoint="MoveFileW", SetLastError=true,

CharSet=CharSet.Unicode, ExactSpelling=true,

CallingConvention=CallingConvention.StdCall)]

public static extern bool MoveFile(String src, String dst);

EntryPoint:指定函数入口，可以用来重新命名函数。（DumpBin.EXE）

[DllImport("Register.dll" EntryPoint="?MyMessage@@YAHPBDZ@Z ")]

public extern static int MyMessage (string str1);

ExactSpelling与CharSet：名称匹配。

在 DllImportAttribute.ExactSpelling 字段为 true 时（Visual Basic .NET 中默认值为true），平台调用将只搜索您指定的名称。例如，如果指定 MessageBox，则平台调用将搜索 MessageBox，如果它找不到完全相同的拼写则失败。

       当 ExactSpelling 字段为 false（它是 C++ 托管扩展和 C# 中的默认值），平台调用将首先搜索指定的别名 (MessageBox)，如果没有找到未处理的别名，则将搜索已处理的名称。当CharSet=CharSet.Ansi时搜索MessageBoxA，找不到则失败；当CharSet= CharSet.Unicode时搜索MessageBoxW，找不到则失败；当CharSet=CharSet.Auto 平台调用在运行时根据目标平台在 ANSI 和 Unicode 格式之间进行选择。

2.      参数传递

先看原函数的定义（已简化）

int __stdcall SMGPSendSingle(

const int nNeedReply,

        const char *sServiceID,

char *sMsgID,

        int *nErrorCode);

（1）

    [DllImport("SmGwAPI.Dll")]

    public extern static int SMGPSendSingle(

           int  nNeedReply,

           string sServiceID,

           StringBuilder sMsgID,

           ref int nErrorCode   );

    （2）

[DllImport("SmGwAPI.Dll")]

    public extern static int SMGPSendSingle(

           int  nNeedReply,

           string sServiceID,

           [MarshalAs(UnmanagedType.LPArray)] byte[]  sMsgID,

           ref int nErrorCode   );

如果sMsgID返回的内容是ASCII码或UNICODE码的字符串，那么使用以上两种定义均可获得正确结果，如果sMsgID返回的内容是二进制码、BCD码等，就必须使用第二种定义方式，才能正确获得返回信息。

3.      结构

原定义（已简化）

typedef struct

{

unsigned int nIsReport;

char       sMsgID[10+1];

char       sMsgContent[252+1];

}DeliverResp;

SMGPAPI_EXPORTS SMGPDeliver(const int nTimeoutIn, DeliverResp *pDeliverResp);

封装处理：

    [StructLayout(LayoutKind.Sequential,CharSet=CharSet.Ansi)]

    public struct DeliverResp

    {

           public uint nIsReport;         

           [MarshalAs(UnmanagedType.ByValTStr,SizeConst=11)]

           public string sMsgID;          

           [MarshalAs(UnmanagedType.ByValTStr,SizeConst=253)]

           public string sMsgContent;        

    }

             

[DllImport("SmGwAPI.Dll")]

public extern static int SMGPDeliver(int nTimeoutIn, ref DeliverResp pDeliverResp);            

如果sMsgID返回的内容是ASCII码或UNICODE码的字符串，那么使用上面定义可获得正确结果，如果sMsgID返回的内容是二进制码、BCD码等，就必须使用下面的定义方式，才能正确获得返回信息。

[StructLayout(LayoutKind.Sequential,CharSet=CharSet.Ansi)]

    public struct DeliverResp

    {

           public uint nIsReport;

           [MarshalAs(UnmanagedType.ByValArray,SizeConst=11 )]

       public byte[] sMsgID;

           [MarshalAs(UnmanagedType.ByValTStr,SizeConst=253)]

           public string sMsgContent;

    }

[DllImport("SmGwAPI.Dll")]

public extern static int SMGPDeliver(int nTimeoutIn, ref DeliverResp pDeliverResp);     

4.    参数对应表

 

C/C++	C#
Int, Long	int
Int *	Ref int
LPCSTR, const char *	[MarshalAs(UnmanagedType.LPSTR)] string
LPCTSTR, const TCHAR *	[MarshalAs(UnmanagedType.LPTSTR)] string
LPSTR, char *	[MarshalAs(UnmanagedType.LPSTR)] stringBuilder
LPTSTR, TCHAR *	[MarshalAs(UnmanagedType.LPTSTR)] stringBuilder
Byte [n] str	[MarshalAs(UnmanagedType.LPArray)]  byte[]str
WORD	uInt16
Byte, unsigned char	byte
Short	Int16
float	single
double	double
DWORD, unsigned long, Ulong	[MarshalAs(UnmanagedType.U4)] UInt32
bool	bool
HANDLE, LPDWORD, LPVOID, void*	IntPtr
NULL pointer	IntPtr.Zero