基于C#的接口基础教程之六(3)-.NET教程,C#语言

com 接口在 c# 中表示为具有 comimport 和 guid 属性的接口。它不能在其基接口列表中包含任何接口，而且必须按照方法在 com 接口中出现的顺序声明接口成员函数。
  
  　　在 c# 中声明的 com 接口必须包含其基接口的所有成员的声明，iunknown 和 idispatch 的成员除外（.net 框架将自动添加这些成员）。从 idispatch 派生的 com 接口必须用 interfacetype 属性予以标记。
  从 c# 代码调用 com 接口方法时，公共语言运行库必须封送与 com 对象之间传递的参数和返回值。对于每个 .net 框架类型均有一个默认类型，公共语言运行库将使用此默认类型在 com 调用间进行封送处理时封送。例如，c# 字符串值的默认封送处理是封送到本机类型 lptstr（指向 tchar 字符缓冲区的指针）。可以在 com 接口的 c# 声明中使用 marshalas 属性重写默认封送处理。
  
  　　在 com 中，返回成功或失败的常用方法是返回一个 hresult，并在 midl 中有一个标记为”retval”、用于方法的实际返回值的 out 参数。在 c#（和 .net 框架）中，指示已经发生错误的标准方法是引发异常。
  默认情况下，.net 框架为由其调用的 com 接口方法在两种异常处理类型之间提供自动映射。
  
  　　返回值更改为标记为 retval 的参数的签名（如果方法没有标记为 retval 的参数，则为 void）。
  
  　　标记为 retval 的参数从方法的参数列表中剥离。
  
  　　任何非成功返回值都将导致引发 system.comexception 异常。
  
  　　此示例显示用 midl 声明的 com 接口以及用 c# 声明的同一接口（注意这些方法使用 com 错误处理方法）。
  
  　　下面是接口转换的c#程序：
  
  using system.runtime.interopservices;
  // 声明一个com接口 imediacontrol
  [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();
  }
  
  　　若要防止 hresult 翻译为 comexception，请在 c# 声明中将 preservesig(true) 属性附加到方法。