MIDL示例【转】

【转】 http://hi.baidu.com/it_new/blog/item/a2f5cd4e58af1b0ab2de05f9.html

MIDL示例

2007-11-29 02:01

IDL是接口定义语言。MIDL是Microsoft的IDL编译器。在用IDL对接口和组件进行了描述后，可以用MIDL进行编译，生成相应的代理和存根DLL的C代码。 import “unknown.idl” ///Interface IX [        object,        uuid(32bb8323-b41b-11cf-a6bb-0080c7b2d682),        helpstring(“IX Interface”),        pointer_default(unique) ] interface IX:IUnknown {        HRESULT FxStringIn([in,string]wchar_t* szIn);        HRESULT FxStringOut([out,string]wchar_t* szout); } import 用于将其他idl文件中的定义包含到当前文件中。   object：       表示所定义的接口是一个COM接口，关键字object是Microsoft对于IDL的一种扩展； uuid(32bb8323-b41b-11cf-a6bb-0080c7b2d682)：        表示相应的IID； helpstring(“IX Interface”)：        将一个帮助串放到一个类型库中； pointer_default(unique) ：        告诉MIDL编译器在没有为指针指定其他属性的时候如何处理该指针；可以当作引用、指针或空等，具体参见《COM技术内幕》第204页；   in关键字告诉MIDL需要将此参数值从客户传递给组件，存根代码不需要送回任何值。 out关键字告诉MIDL参数仅被用来从组件向客户传回有关的数据， COM对字符串的标准约定是Unicode字符（即wchar_t）；IDL文件可以定义C和C++风格的结构，并可用它们作为函数的参数。 当IDL文件中有一个library时，MIDL将生成一个类型库。L为接口生成相应的代理和存根的C代码。 为得到一个代理/存根DLL，需要编译和链接MIDL生成的C文件。 宏REGISTER_PROXY_DLL将完成代理/存根DLL在注册表中的注册操作。 有了IDL和MIDL我们就可以象调用进程内组件那样进行跨进程边界的函数调用，并对参数进行列集。 当IDL文件定义了library的时候，MIDL将会生成一个类型库，该类型库包括了在library block中每个元素的定义，以及在block外定义但在该bloack中引用元素的定义。 You can use a single IDL file to generate both the proxy stubs and header files for marshaling code, and a type library. You do this by defining an interface outside the library block and then referencing that interface from inside the library block.   MIDL编译器将生成XX.H XX_.C XX_P.C DLLDATA.C几个文件，其作用分别为： XX.H        一个同C和C++兼容的，包含IDL中所描述的所有接口声明的头文件； XX_.C     一个定义有IDL文件中所用的所有GUID的C文件 XX_P.C     一个实现IDL文件中接口的代理及残根的C文件 DLLDATA.C 一个包含代理和残根的DLL的C文件 --------------------------------------------------------------------------------------------- ------------------------------------------------------------------------------------------- import "unknwn.idl"; [ object,uuid(9955EBD9-C24D-4b18-9D88-D6049ADDCBC8) ] interface ICalculator : IUnknown { HRESULT Add ( [in] long v1, [in] long v2, [out, retval] long* pVal ); HRESULT Subtract ( [in] long v1, [in] long v2, [out, retval] long* pVal ); HRESULT Multiply ( [in] long v1, [in] long v2, [out, retval] long* pVal ); HRESULT Divide ( [in] long v1, [in] long v2, [out, retval] long* pVal ); } [ uuid(F1B9F274-5B16-4033-BECD-9C05BB6072AE) ] library CalcualtorLib { [ uuid(0A6C37B3-3577-48a7-9485-5F10ED190ECF) ] coclass CCalculator {    interface ICalculator; } }; 笔者在编译上面的IDL文件时,产生下列错误: D:/Work/Math/Calculator.idl(3) : error MIDL2311 : statements outside library block are illegal in mktyplib compatability mode : [ Interface 'ICalculator' ] D:/Work/Math/Calculator.idl(3) : error MIDL2096 : duplicated attribute : [uuid] [ Interface 'ICalculator' ] Error executing midl.exe. 察看MSDN,发现原因是：     需要在project中将IDL文件的MIDL/mktyplib203选项去掉.   【示例2】 所有数据、方法、接口、类和库的特性都由属性信息来描述。属性信息中由括号括起来，作为它们描述的对象的前缀。 [in] : 告诉MIDL编译器生成代码时，只是把从客户到对象的数据列集，没必要把同样的数据列集送回给客户 [out] : 让一段数据从对象返回到客户。 ------------------------------------------------------------------------- IUnknown接口定义 import "unknwn.idl"; [ local,object    uuid(FAEAE6B7-67BE-42a4-A318-3256781E945A),    pointer_default(unique) ] interface IUnknown {     typedef(unique) IUnknown *LPUNKNOWN     cpp_quote("/")     cpp_quote("//IID_IUnknown和其他所有的系统IID都是由UUID.LIB提供的")     cpp_quote("//把这个函数库与你的代理、客户和服务链接起来")     cpp_quote("/")     HRESULT QueryInterface( [in] REFIID iid,                             [out,iid_is(riid)] void **ppObject );     ULONG AddRef();     ULONG Release(); } ----------------------------------------------------------------------------- [object] : 指定接口是一个com接口。如果遗漏这个属性信息，那IOcr接口只是一个简单的MS RPC接口；如果没有这个属性信息，所生成的列集代码将与COM函数库（运行时）提供的标准列集代码不兼容。 [UUID] : 这是IOcr接口静态的和唯一的IID，它是一个在时间上和空间上独一无二的机器生成数字。 [local] : 告诉MIDL编译器,不要生成接口代理和存根。 [pointer_default()] : 设定了所有还没有显示限定的嵌入式指针（embedded pointer）的默认指针属性信息。嵌入式指针（embedded pointer）包括结构体（structrue）、联合体（union）、数组（array）的成员指针.    unique属性信息：1)[ref]指针是引用指针（reference pointer），不能为空。                             2)[unique]指针是简单指针（simple pointer），可以为空。但是代理不提供对重复指针探测的支持。例如，若ptr1/ptr2都                                指向同一个数据，那个数据的两份相同的副本会被送往远程对象。                             3)[ptr]指针是完全指针（full pointer）。若ptr1/ptr2都指向同一个数据，只有一个副本会被送往远程对象。 cpp_quote：指导MIDL编译器将限定了的字符串转换成生成的头文件。具体来说，这四行会在MIDL编译器生成的头文件中做出C++的注释。 [iid_is()] : 这是一个指针属性，它与[ptr][ref][unique]相似，只适用于指针。iid_is(riid)属性列集器关心，实际上，存根需要准确地知道正在调度的接口指针（riid,某种IID） [size_is()] : 显示地告诉列集器，指针实际指向一些字节的块。列集器根据这个块的大小分配内存。 [string] : 提示列集器：修饰的本参数是一个字符串，是以null终止的。