使用ATL建立支持IClassFactory2的COM组件

类别:VC语言 点击:0 评论:0 推荐:

使用ATL建立支持IClassFactory2的COM组件

 

关键字:COM、IClassFactory2、对象创建权限、License、License Key

 

本文详细描述了如何使用ATL自身的功能创建具有创建权限功能的COM对象。最后还讲述了如何创建具有固定和临时权限的COM对象,以及如何获取注册码。

1      概述

IClassFactory2接口的作用是为给COM对象增加限制控制的功能。通过这个接口,只能在有合法使用权的电脑上才可以创建COM对象的实例。

COM对象的权限有两种,一种是固定权限,在创建COM对象之前就存在电脑中,创建COM对象时不需要提供附加的信息。另一种是临时的权限,在创建对象的时候必须提供表明具有权限的注册码,临时权限不能保留在电脑中,所以,每次创建实例的时候都需要提供注册码。每个COM对象可以选择使用固定权限方式、临时权限方式或两者都使用。

COM对象可以提供取得注册码的功能。通过这个功能,可以在具有固定权限的电脑上获取的注册码。

在COM对象被创建的时候,应该检查注册码或者固定权限的信息,如果COM对象判定用户没有使用权限,可以返回CLASS_E_NOTLICENSED。

2      ATL对IClassFactory2的支持

ATL完全支持IClassFactory2。通过宏DECLARE_CLASSFACTORY2声明COM对象支持IClassFactory2接口。DECLARE_CLASSFACTORY2宏需要一个License类实现具体的许可权限验证算法和注册码验证算法。License类可以使用任何名字,其中必须定义如下的几个成员函数。License类的形式如下:

 

class CLicenseCls

{

protected:

  static BOOL VerifyLicenseKey(BSTR bstr);

  static BOOL GetLicenseKey(DWORD dwReserved, BSTR* pBstr);

  static BOOL IsLicenseValid();

};

 

VerifyLicenseKey函数用于验证注册码的合法性。GetLicenseKey用于获取注册码。IsLicenseValid函数用于验证是否存在固定的使用权限。

用户可以根据需要,提供这三个函数的实现。如下表:

所需功能

VerifyLicenseKey

GetLicenseKey

IsLicenseValid

不检查权限

FALSE

FALSE

TRUE

固定权限

FALSE

FALSE

检查固定权限

临时权限

检测注册码

FALSE

FALSE

固定权限和

临时权限

检测注册码

FALSE

检查固定权限

固定权限和

临时权限和

获取注册码

检测注册码

返回注册码

检查固定权限

3      实现方式 3.1     License类

实现License类的成员函数:

 

class CMyLicense

{

protected:

static BOOL VerifyLicenseKey(BSTR bstrLicenseKey)

{

  if (wcscmp(bstrLicenseKey, OLESTR("Template License Key")) == 0)

  {

    return TRUE;

  }

  return FALSE;

}

 

static BOOL GetLicenseKey(DWORD dwReserved, BSTR* pBstrLicenseKey)

{

  if (pBstrLicenseKey)

  {

    * pBstrLicenseKey = SysAllocString(OLESTR("Template License Key "));

  }

  return TRUE;

}

 

static BOOL IsLicenseValid() {  return TRUE; }

};

 

以上例子中,IsLicenseValid函数永远返回真。在实际使用中,要验证电脑中是否存在固定权限。如果存在固定权限则返回真,否则返回假。这个例子中使用的是固定注册码,也可以根据需要使用伪随机注册码。

3.2     实现IClassFactory2接口

在ATL的COM对象类中通过DECLARE_CLASSFACTORY2宏声明在类对象中使用IClassFactory2接口。DECLARE_CLASSFACTORY2宏的定义如下:

 

DECLARE_CLASSFACTORY2(lic)

 

其中lic是License类的名称,本例中为CMyLicense。

4      创建需要License的COM对象 4.1     具有固定权限的COM对象

创建具有固定权限的COM对象的方法和创建普通COM对象是相同的。不需要提供任何附加的信息。

使用CoCreateInstance可以方便的创见固定权限的COM对象。CoCreateInstance的定义如下:

 

STDAPI CoCreateInstance(

REFCLSID rclsid,

LPUNKNOWN pUnkOuter,

DWORD dwClsContext,

REFIID riid,

LPVOID * ppv

);

 

rclsid是要创建对象的CLSID。

pUnkOuter用于聚合的情况,不使用聚合的时候,使用NULL。

dwClsContext指定COM对象的运行环境,一般情况使用CLSCTX_ALL表示可以在任何环境运行。

riid是需要返回的接口的IID。

ppv是返回的接口指针的地址。

具体代码如下:

 

Iyyy * pObj;

HRESULT hr;

hr = CoCreateInstance(CLSID_xxx, NULL, CLSCTX_ALL, IID_yyy, &pObj);

if (FAILED(hr))

{

    ...

}

 

4.2     使用临时权限

使用临时权限创建COM对象,需要一个注册码。注册码可以从COM对象本身获取,也可以通过其它方式取得(如购买等)。使用临时权限创建COM对象需要两个步骤:取得COM类对象和创建COM对象。

4.2.1        取得COM类对象

通过CoGetClassObject函数,可以获取类对象。CoGetClassObject的定义如下:

 

STDAPI CoGetClassObject(

REFCLSID rclsid,

DWORD dwClsContext,

COSERVERINFO * pServerInfo,

REFIID riid,

LPVOID * ppv

);

 

rclsid是要创建COM对象的CLSID。

dwClsContext是COM对象的运行方式,一般情况使用CLSCTX_ALL表示可以在任何环境运行。

pServerInfo用于在另一台电脑上创建COM对象,在本地创建时用NULL。

riid是所需要的接口的IID,这里使用IID_IClassFactory2。

ppv是返回接口指针的地址。

可以看出,前两个参数和在CoCreateInstance中的定义是相同的。

具体代码:

 

    IClassFactory2 * pCF2;

    HRESULT hr;

  hr = CoGetClassObject(CLSID_xxx, CLSCTX_ALL, NULL,

IID_IClassFactory2, (void **)&pCF2);

    if (FAILED(hr))

{

    ...

}

    ...

       

4.2.2        创建对象

通过IClassFactory2的CreateInstanceLic方法,可以使用临时权限创建对象。在取得了COM类对象之后,调用CreateInstanceLic方法,并且把注册码作为参数,就可以得到新建的COM对象的接口指针。

CreateInstanceLic的定义如下:

 

HRESULT CreateInstanceLic(

IUnknown* pUnkOuter,

IUnknown* pUnkReserved,

REFIID riid,

BSTR bstrKey,

void** ppvObject

);

 

pUnkOuter是聚合的外部对象指针,在不使用聚合的时候,用NULL。

pUnkReserved是保留的参数,用NULL。

riid是所需要返回的接口IID。

bstrKey是注册码。

ppvObject是保存返回的接口指针的地址。

具体代码:

 

Ixxx * pObj;

hr = pCF2->CreateInstanceLic(NULL, NULL, IID_Ixxx,

bstrLicenseKey, (void**) &pObj);

if (FAILED(hr))

{

    ...

}

 

创建之后就可以像使用普通COM对象一样使用新建的COM对象。

4.3     获取注册码

首先要取得类对象的指针,详见第4.2.1节。

在取得了IClassFactory2的指针之后,通过RequestLicKey方法可以取得注册码。

RequestLicKey的定义如下:

 

HRESULT RequestLicKey(

  DWORD dwReserved,

  BSTR* pbstrKey

);

 

dwReserved是保留参数,用0。

pbstrKey是保存返回的注册码的地址。调用方负责释放返回值的地址。

具体代码:

 

BSTR bstrLicKey;

hr = pCF2->RequestLicKey(0, &bstrLicKey);

if (FAILED(hr))

{

    ...

}

...

SysFreeString(bstrLicKey);

 

本文地址:http://com.8s8s.com/it/it1729.htm