IDL接口描述语言和COM接口COM组件

此生再无相见时 提交于 2019-12-07 09:48:04

接口描述语言(Interface description language,缩写IDL

c++写的接口,只能c++和c识别,为了接口的通用性,让所有的语言都通用的定义使用接口
引入IDL,使用IDL定义接口以后,用MIDL编译为c++可用的接口定义

  接口描述语言 - IDL(Interface Definition Language )

   1 IDL和MIDL

     IDL - 定义接口的一种语言,与开发
       语言无关.
     MIDL.EXE - 可以将IDL语言定义接口,
       编译成C++语言的接口定义

   2 IDL的基础

IDL接口定义方式:
在项目中添加**.idl文件,在文件中:
1导入idl
      import "XXXX.idl"
2定义属性     
      [
        attribute
      ]
3定义接口
      interface A : interface_base
      {
      }
编译后生成三个文件
**_h.h 接口头文件
**_i.cpp 接口GUID
**_p.cpp 远程调用相关,代理层
   
    2.1 Import 导入IDL文件,相当于C++的
        #include
    2.2 使用"[]"定义区域,属性描述
      关键字,描述接口GUID等信息
       1) object - 后续是对象
       2) uuid - 定义对象GUID
       3) helpstring - 帮助信息
       4) version - 版本
       5) point_default - 后续对象
         中指针的默认使用方式
         比如: uniqune - 表示指针可以
           为空,但是不能修改
  
    2.3 对象定义
       1) 父接口是IUnknown接口      
       2) 在对象内添加函数,函数定义必须
       是返回 HRESULT.
       HRESULT是32位整数,返回函数是否
       执行成功,需要使用 SUCCESSED和
       FAILED宏来判断返回值.

COM接口  

按照COM规范定义的接口,即为COM接口

    1 COM接口的规范

1.1 IUnknown接口的等价性 -
判断两个接口相等,需要获取两个接口的IUnknown接口
判断IUnknown接口的地址是都相等。
1.2自反性
接口可以使用QueryInterface查询到自己
1.3 对称性
接口A可以查询到接口B,那么接口B也可以查询到接口A
1.4 传递性
接口A可以查询到接口B,接口B可以查询到接口C,那么接口A就可以查询到接口C
1.5 时间无关性
接口A在某个时间可以查询到接口B,那么在后续的任何时间中也可以查询到接口B

    2 接口的编写

2.1 定义IDL(编译后生成3个文件)
IDL文件项目属性有了 MIDL(将IDL定义的接口编译为c++语言)选项,其中Mktyplib compa...选项去掉,组件内部相关,不去掉IDL编译失败
*_i.c 接口ID定义   
*_h.h 接口头文件
*_p.c 接口代理层实现
2.2 实现接口
自定义实现类继承接口类,并实现相关函数,注意引入相关头文件(接口头文件和GUID定义文件)
自定义实现类中实现相关函数时必须使用STDMETHOD(无返回值)STDMETHOD_(有返回值)声明函数,STDMETHODIMP STDMETHODIMP_实现函数
2.3 实现接口的导出
实现全局接口创建函数
定义def文件中导出接口创建函数

COM组件

    1 COM接口和COM组件

      COM接口 - 函数集合
      COM组件 - 
从接口角度:COM组件是一个接口的集合
        从C++语言看:COM组件是一个类或多个类
从编程看:COM组件是一段可以执行的代码
      COM组件通过一个或多个COM接口展示自己的功能
    ---------
||----o IUnknown  接口
|组件|
||----o IMath   接口
||
---------

    2 组件的实现

2.1 定义类实现组件的功能
2.2 每个组件都具有一个GUID
一般宏定义为:CLSID_组件名称
2.3 在IDL中,定义组件
[
uuid(39B16755-783D-49B1-93E2-0FCA9F66CC2D)
]
coclass Math
{
interface IMath;
};
2.4 创建组件,并获取接口
创建时传入组件GUID,在查询接口时加入组件GUID的判断

IDL实现COM组件代码示例

math.idl

import "oaidl.idl";
import "ocidl.idl";
import "objidl.idl";

[
	object,
	uuid(CFF0849D-61E2-4ED1-9DC9-0E43E2FBDE25)
]

interface IMath :IUnknown
{
	HRESULT Add(long nAdd1, long nAdd2, long* pnAdd) = 0;
	HRESULT Sub(long nSub1, long nSub2, long* pnSub) = 0;
};
[
	uuid(39B16755-783D-49B1-93E2-0FCA9F66CC2D)
]
coclass Math
{
	interface IMath;
};


CimpMath.h

#pragma once
#include "math_h.h"

class ClmpMath:public IMath
{
public:
	ClmpMath();
	~ClmpMath();
//IUnKnuwn
public:
	STDMETHOD(QueryInterface)(REFIID iid, LPVOID* ppiObject);
	STDMETHOD_(ULONG, AddRef)();
	STDMETHOD_(ULONG, Release)();
//IMath
public:
	STDMETHOD(Add)(long nAdd1, long nAdd2, long* pnAdd);
	STDMETHOD(Sub)(long nSub1, long nSub2, long* pnSub);
//
public:
	LONG m_nRef;
};

CimpMath.cpp

#include "stdafx.h"
#include "ClmpMath.h"


ClmpMath::ClmpMath()
{
	m_nRef = 0;
}


ClmpMath::~ClmpMath()
{
}

STDMETHODIMP ClmpMath::QueryInterface(
	REFIID iid, LPVOID* ppiObject)
{
	if (iid == IID_IUnknown)
	{
		*ppiObject = static_cast<IUnknown*>(this);
	}
	else if (iid == IID_IMath)
	{
		*ppiObject = static_cast<IMath*>(this);
	}
	else
	{
		*ppiObject = NULL;
		return E_NOINTERFACE;
	}
	AddRef();
	return S_OK;
}

STDMETHODIMP_(ULONG)ClmpMath:: AddRef()
{
	InterlockedIncrement(&m_nRef);
	return m_nRef;
}
STDMETHODIMP_(ULONG)ClmpMath::Release()
{
	InterlockedDecrement(&m_nRef);
	if (m_nRef == 0)
	{
		delete this;
	}
	return m_nRef;
}

STDMETHODIMP ClmpMath::Add(
	long nAdd1, long nAdd2, long* pnAdd)
{
	if (pnAdd == NULL)
	{
		return E_POINTER;
	}
	*pnAdd = nAdd1 + nAdd2;
	return S_OK;
}
STDMETHODIMP ClmpMath::Sub(
	long nSub1, long nSub2, long* pnSub)
{

	if (pnSub == NULL)
	{
		return E_POINTER;
	}
	*pnSub = nSub1 + nSub2;
	return S_OK;
}

组件创建函数

IUnknown* CreateInstanceEx(CLSID clsid)
{//判断组件的CLSID
	if (clsid == CLSID_Math)
	{
		//创建对象
		ClmpMath* pMath = new ClmpMath;
		//获取接口
		IUnknown* piUnknown = NULL;
		pMath->QueryInterface(IID_IUnknown,
			(LPVOID*)&piUnknown);
		//返回接口
		return piUnknown;
	}

	return FALSE;
}


易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!