ODL参考手册（二）：interface表达式

最新推荐文章于 2025-03-12 16:53:35 发布

转载最新推荐文章于 2025-03-12 16:53:35 发布 · 565 阅读

文章标签：

#interface #attributes #pascal #returning #string #module

组件自动化

interface(组件自动化)

这个表达式定义一个接口，接口就是一个函数定义的集合．一个接口可以继承于任何基接口．

[attributes]

interface interfacename[:baseinterface]{

functionlist

};

语法元素：

attributes

在一个interface表达式前面接受dual , helpstring , helpcontext , hidden , odl , oleautomation , uuid 和 version 属性．其中 odl , uuid 属性是必须的．如果这个接口是一个COM对象的接口，source , default 和 restricted 也被接受．想了解这些属性的详细信息，可参考下一章．

interfacename

接口的名字

baseinterface

接口的父接口的名字．

functionlist

接口中每个函数的函数原形的列表．在这个函数列表中可以出现任意数量的函数定义．在函数列表中的函数定义使用下面的形式：

[attributes] returntype [calling convention] funcname(params);

接口里一个函数定义中可以接受下面的属性：helpstring , helpcontext , string , propget , propput , propputref , bindable , defaultbind , displaybind 和 vararg ．如果 vararg 被指定，最后一个参数必须是VARIANT类型的安全数组．可选的调用惯例可以是 _pascal / _pascal / pascal , _cdecl / _cdecl / cdecl 或者 __stdcall / _stdcall / stdcall．调用协定

参数列表是一个用逗号分隔的列表，向下面这样：

[attributes] type paramname

类型可以是任何先前已经定义的类型，内置类型，指向任何类型的指针，指向内置类型的指针等．参数的属性有 in , out , optional 和 string．

如果使用了 optional ，它必须指定最右边的参数，而且参数的类型必须是VARIANT．

备注

因为用interface描述的函数存在于VTBL，DispInvoke 与 CreateStdDispatch 可以用于提供一个IDispatch::Invoke的实现．因为这个原因，在描述一个对象的属性或方法时interface 的使用比 dispinterface 更普遍．

在interface里描述一个函数，与在一个module表达式里描述是基本致的，除了entry属性不允许使用．

接口里的成员可能会产生异常，所以应该返回HRESULT值，而且应该为真实返回值指定一个返回参数．返回参数总是列表中最后一个参数．

例子

下面的例子定义了一个名字为Hello的接口，有两个成员函数，HelloProc和Shutdown:

[uuid(BFB73347-822A-1068-8849-00DD011087E8), version(1.0)]

interface hello : IUnknown