分享
 
 
 

详细介绍组件对象模型的规则

王朝other·作者佚名  2008-05-19
窄屏简体版  字體: |||超大  

规则1:必须实现Iunknown

如果一个对象没有至少实现一个最小程度为IUnknown的接口,那它就不是Microsoft的组件对象模型(COM)。

接口设计规则

接口必须直接或间接地从IUnknown继承。

接口必须有唯一的识别(IID)。

接口是不变的。一旦分配和公布了IID,接口定义的任何因素都不能被改变。

接口的成员函数应该有HRESULT类型的返回值,使远端结构可报告远程过程调用(RPC)错误的情况。

接口成员函数的字符串参数应该是Unicode。

实现 IUnknown

对象的同一性。这要求对任何特定IUnknown接口的给定对象实例的QueryInterface调用返回相同的物理指针变量。这导致了所谓的两个接口的QueryInterface(IID_IUnknown, ...)和结果的比较,以确定它们是否为同一对象(COM对象同一性)。

静态接口的设置。任何经由QueryInterface来访问对象的接口的设置,必须是静态而不是动态的。也就是说,假如一旦QueryInterface获得了一个给定的IID,那么它总是对相同的对象(除非有意想不到情况)调用,假如QueryInterface不能获得一个给定的IID,那么随后对相同IID的对象调用必定会失败。

对象完整性。对于可处理的接口设置,必须有反身性,对称性和过渡性。即给定代码如下:

IA * pA = (some function returning an IA*);

IB * pB = NULL;

HRESULT hr;

hr = pA-QueryInterface(IID_IB,&pB); // line 4

Symmetric: pA-QueryInterface(IID_IA, ...) must succeed (aa)

Reflexive: If, in line 4, pB was successfully obtained, then

pB-QueryInterface(IID_IA, ...)

must succeed (ab, then ba).

Transitive: If, in line 4, pB was successfully obtained, and we do

IC * pC = NULL;

hr = pB-QueryInterface(IID_IC, &pC); //Line 7

and pC is successfully obtained in line 7,then

pA-QueryInterface(IID_IC, ...)

must succeed (ab, and bc,then ac).

最小参考服务大小。我们需要实现AddRef来维护一个服务台,它足够大以便支持给定对象的所有接口的2 31 ?1有出色的整体指示服务。一个32-位的无符号整型数满足要求。

Release并不意味着失败。假如客户想知道关于资源已被释放等情况,就必须在调用Release之前使用一些对象接口中的较高的语义。

内存管理规则

接口指针的生命期管理总是通过建立在每个COM接口上的AddRef和Release方法来实现。(参见下面的“引用计数规则”)

下面的规则适用于接口成员函数的参数,包括不是“按值”传递的返回值。

对于参数来说,调用程序应分配和释放内存。

出口参数必须由被调用程序分配,由调用程序用标准的COM内存分配程序来释放。

出入参数首先由调用程序分配,必要时由被调用程序释放及重分配。至于出口参数,调用程序有责任释放最终返回变量。此时必须使用标准的COM内存分配程序。

假如函数返回调用失败的代码,则通常调用者没办法清除出口和入出口参数。这导致了一些附加规则:

错误返回时,出口参数必须可靠地被设置成可清除变量,它不能对调用程序有影响。

此外,所有的出口指针参数(包括调用分配,被调用委任结构)必须被明显地设为NULL。最直接的方法是在函数说明项中设成NULL。

返回错误时,所有的入出口参数必须为被调用者所搁置(这样保持为调用程序初始化的值;若调用程序没有对它初始化,则它是个出口参数,不是入出口参数),或者被明显地设为出口错误返回情况。

参考计数规则:

规则1:对于接口指针的每一个新的副本,AddRef必须被调用;Release在接口指针的每一个破坏时调用,除了子规则明显允许了其他情况。

以下规则对应于规则1的非例外情况。

规则1a:函数的入口出口参数。调用程序必须AddRef实际参数,因为当出口变量存放在它之上时,将由被调程序释放。

规则1b:获取全局变量。从全局变量的已存在的指针副本得到的接口指针的局部副本,必须被独立地引用计数。因为存在局部副本时,被调函数会破坏全局副本。

规则1c:新指针合成所需资源不多。函数使用内在知识合成接口指针,而不是从其他资源所得,此时必须对新指针做初始AddRef。这样的重要例子有事例生成法则,Iunknown::QueryInterface的实现,等等。

规则1d:内部存储指针副本的返回。指针返回之后,被调程序不知道它的生命期和指针的内部存储副本如何联系。所以,被调程序必须在返回前对指针副本调用AddRef。

规则2:对于接口指针的两个或更多的副本,它们的生命期的起始和终了的关系代码的特定知识,使AddRef/Release可以被省略。

从COM客户的角度,引用计数是和接口对应的概念。客户不应认为对象的所有接口有同一引用计数。

不应依赖于Addref & Release的返回值,而应用于调试目的。

指针稳定性;参见在"Reference-Counting Rules"下的OLE帮助文件中的子部分:"Stabilizing the this Pointer and Keeping it Valid"。

参见Douglas Hodges写的优秀的技术文章"Managing Object Lifetimes in OLE",及Kraig Brockschmidt (MSDN Library, Books)写的Inside OLE的第三章来获取更多信息。

COM申请责任:

以客户,服务器,对象执行者之一身份使用COM的每一进程,要对三件事负责:

确定COM库是同COM函数CoBuildVersion一致的版本。

在使用其他函数之前通过调用CoInitialize初始化COM库。

在不用CoUninitialize时取消COM库的初始化。

进程内服务器能假定载入的进程已执行了这些步骤。

服务器规则

进程内服务器必须输出DllGetClassObject and DllCanUnloadNow。

进程内服务器必须支持COM自注册。

进程内和局部服务器应该在它们的文件版本信息中提供OLESelfReg字符串。

进程内服务器必须输出DllRegisterServer and DllUnRegisterServer。

局部服务器应支持/RegServer and /UnRegServer命令行开关。

生成集合对象

生成可合计的对象是可选的,且操作简单,有诸多益处。以下规则使用于创建可合计的对象(通常称为内部对象)。

由QueryInterface, AddRef, 和 Release对IUnknown接口的内部对象执行单独控制内部接口的引用计数,且不能授权给外部未知指针。这种IUnknown执行称为隐式IUnknown。

内部对象执行接口的QueryInterface, AddRef, 和 Release成员的实行,除了IUnknown自己,都必须授权给外部未知指针。这些实施不能直接影响内部对象的参考计数。

隐式Iunknown只对内部对象实施QueryInterface操作。

集合对象在占用外部未知指针参考时,不能调用AddRef。

如果当对象创建时,需要除Iunknown外的任一接口,创建失败同E_UBKNOWN一起。

以下的代码段阐明了使用嵌套类来实现集合对象接口的范例:

// CSomeObject is an aggregatable object that implements

// IUnknown and ISomeInterface

class CSomeObject : public IUnknown

{

private:

DWORD m_cRef;// Object reference count

IUnknown* m_pUnkOuter; //Outer unknown, no AddRef

// Nested class to implement the ISomeInterface interface

class CImpSomeInterface: public ISomeInterface

{

friend class CSomeObject ;

private:

private:DWORD m_cRef; //Interface ref-count, for debugging

private:IUnknown*m_pUnkOuter; // Outerunknown, for delegation

private:public:

private:CImpSomeInterface() { m_cRef = 0; };

private:~ CImpSomeInterface(void) {};

private:// IUnknown members delegate to the outer unknown

private:// IUnknown members do not control lifetime of object

private:STDMETHODIMP QueryInterface(REFIID riid, void** ppv)

private:{ return m_pUnkOuter-QueryInterface(riid,ppv);};

private:STDMETHODIMP_(DWORD) AddRef(void)

private:{ return m_pUnkOuter-AddRef(); };

private:STDMETHODIMP_(DWORD) Release(void)

private:{ return m_pUnkOuter-Release();};

private:// ISomeInterface members

private:STDMETHODIMP SomeMethod(void)

private:{ return S_OK; };

private:} ;

private:CImpSomeInterface m_ImpSomeInterface ;

private:public:

private:CSomeObject(IUnknown * pUnkOuter)

{

m_cRef=0;

// No AddRef necessary if non-NULL as we're aggregated.

m_pUnkOuter=pUnkOuter;

m_ImpSomeInterface.m_pUnkOuter=pUnkOuter;

} ;

// Static member function for creating new instances (don't use

// new directly).Protects against outer objects asking for interfaces

// other than IUnknown

static HRESULT Create(IUnknown* pUnkOuter, REFIID riid, void **ppv)

 
 
 
免责声明:本文为网络用户发布,其观点仅代表作者个人观点,与本站无关,本站仅提供信息存储服务。文中陈述内容未经本站证实,其真实性、完整性、及时性本站不作任何保证或承诺,请读者仅作参考,并请自行核实相关内容。
2023年上半年GDP全球前十五强
 百态   2023-10-24
美众议院议长启动对拜登的弹劾调查
 百态   2023-09-13
上海、济南、武汉等多地出现不明坠落物
 探索   2023-09-06
印度或要将国名改为“巴拉特”
 百态   2023-09-06
男子为女友送行,买票不登机被捕
 百态   2023-08-20
手机地震预警功能怎么开?
 干货   2023-08-06
女子4年卖2套房花700多万做美容:不但没变美脸,面部还出现变形
 百态   2023-08-04
住户一楼被水淹 还冲来8头猪
 百态   2023-07-31
女子体内爬出大量瓜子状活虫
 百态   2023-07-25
地球连续35年收到神秘规律性信号,网友:不要回答!
 探索   2023-07-21
全球镓价格本周大涨27%
 探索   2023-07-09
钱都流向了那些不缺钱的人,苦都留给了能吃苦的人
 探索   2023-07-02
倩女手游刀客魅者强控制(强混乱强眩晕强睡眠)和对应控制抗性的关系
 百态   2020-08-20
美国5月9日最新疫情:美国确诊人数突破131万
 百态   2020-05-09
荷兰政府宣布将集体辞职
 干货   2020-04-30
倩女幽魂手游师徒任务情义春秋猜成语答案逍遥观:鹏程万里
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案神机营:射石饮羽
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案昆仑山:拔刀相助
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案天工阁:鬼斧神工
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案丝路古道:单枪匹马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:与虎谋皮
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:李代桃僵
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:指鹿为马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:小鸟依人
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:千金买邻
 干货   2019-11-12
 
推荐阅读
 
 
 
>>返回首頁<<
 
靜靜地坐在廢墟上,四周的荒凉一望無際,忽然覺得,淒涼也很美
© 2005- 王朝網路 版權所有