C#声明COM接口浅谈-c#调用com接口

学习C#语言时，经常会遇到C#声明COM接口问题，这里将介绍C#声明COM接口问题的解决方法。

COM 接口在 C# 中表示为具有 ComImport 和 Guid 属性的接口。它不能在其基接口列表中包含任何接口，而且必须按照方法在 COM 接口中出现的顺序声明接口成员函数。

C#声明COM接口必须包含其基接口的所有成员的声明，IUnknown 和 IDispatch 的成员除外（.NET 框架将自动添加这些成员）。从 IDispatch 派生的 COM 接口必须用 InterfaceType 属性予以标记。

从 C# 代码调用 COM 接口方法时，公共语言运行库必须封送与 COM 对象之间传递的参数和返回值。对于每个 .NET 框架类型均有一个默认类型，公共语言运行库将使用此默认类型在 COM 调用间进行封送处理时封送。例如，C# 字符串值的默认封送处理是封送到本机类型 LPTSTR（指向 TCHAR 字符缓冲区的指针）。可以在C#声明COM接口中使用 MarshalAs 属性重写默认封送处理。

在 COM 中，返回成功或失败的常用方法是返回一个 HRESULT，并在 MIDL 中有一个标记为"retval"、用于方法的实际返回值的 out 参数。在 C#（和 .NET 框架）中，指示已经发生错误的标准方法是引发异常。

默认情况下，.NET 框架为由其调用的 COM 接口方法在两种异常处理类型之间提供自动映射。返回值更改为标记为 retval 的参数的签名（如果方法没有标记为 retval 的参数，则为 void）。标记为 retval 的参数从方法的参数列表中剥离。任何非成功返回值都将导致引发 System.COMException 异常。此示例显示用 MIDL 声明的 COM 接口以及用 C# 声明的同一接口（注意这些方法使用 COM 错误处理方法）。

下面是一个使用C# 映射媒体播放机COM 对象的程序。

using System;  
using System.Runtime.InteropServices;  
namespace QuartzTypeLib  
{  
//声明一个COM接口 IMediaControl，此接口来源于媒体播放机COM类  
[Guid("56A868B1-0AD4-11CE-B03A-0020AF0BA770"),  
InterfaceType(ComInterfaceType.InterfaceIsDual)]  
interface IMediaControl  
{ //列出接口成员  
void Run();  
void Pause();  
void Stop();  
void GetState( [In] int msTimeout, [Out] out int pfs);  
void RenderFile(  
[In, MarshalAs(UnmanagedType.BStr)] string strFilename);  
void AddSourceFilter(  
[In, MarshalAs(UnmanagedType.BStr)] string strFilename,  
[Out, MarshalAs(UnmanagedType.Interface)]  
out object ppUnk);  
[return: MarshalAs(UnmanagedType.Interface)]  
object FilterCollection();  
[return: MarshalAs(UnmanagedType.Interface)]  
object RegFilterCollection();  
void StopWhenReady();  
}  
//声明一个COM类:  
[ComImport, Guid("E436EBB3-524F-11CE-9F53-0020AF0BA770")]  
class FilgraphManager //此类不能再继承其它基类或接口  
{  
//这里不能有任何代码 ，系统自动增加一个缺省的构造函数  
}  
}  
class MainClass  
{  
public static void Main(string[] args)  
{  
//命令行参数:  
if (args.Length != 1)  
{  
DisplayUsage();  
return;  
}  
String filename = args[0];  
if (filename.Equals("/?"))  
{  
DisplayUsage();  
return;  
}  
// 声明FilgraphManager的实类对象：  
QuartzTypeLib.FilgraphManager graphManager =new QuartzTypeLib.FilgraphManager();  
//声明IMediaControl的实类对象：:  
QuartzTypeLib.IMediaControl mc =(QuartzTypeLib.IMediaControl)graphManager;  
// 调用COM的方法：  
mc.RenderFile(filename);  
//运行文件.  
mc.Run();  
//暂借停.  
Console.WriteLine("Press Enter to continue.");  
Console.ReadLine();  
}  
private static void DisplayUsage()  
{ // 显示  
Console.WriteLine("媒体播放机: 播放 AVI 文件.");  
Console.WriteLine("使用方法: VIDEOPLAYER.EXE 文件名");  
}  
}  
运行示例：  
若要显示影片示例 Clock.avi，请使用以下命令：  
interop2 %windir%\clock.avi  
这将在屏幕上显示影片，直到按 ENTER 键停止。  
在 .NET 框架程序中通过DllImport使用 Win32 API  
.NET 框架程序可以通过静态 DLL 入口点的方式来访问本机代码库。
DllImport 属性用于指定包含外部方法的实现的dll 位置  
DllImport 属性定义如下：  
namespace System.Runtime.InteropServices  
{  
[AttributeUsage(AttributeTargets.Method)]  
public class DllImportAttribute: System.Attribute  
{  
public DllImportAttribute(string dllName) {...}  
public CallingConvention CallingConvention;  
public CharSet CharSet;  
public string EntryPoint;  
public bool ExactSpelling;  
public bool PreserveSig;  
public bool SetLastError;  
public string Value { get {...} }  
}  
}

【编辑推荐】