什么是com接口

什么是com接口,第1张

一)COM接口就是指Cluster communication port接口,即串行通讯端口。有9 针D 形连接器,也称之为RS-232接口。

也有的使用的是老式的DB25 针连接器,也称之为RS-422接口,这种接口目前已经很少使用。

二)也有人将COM component(COM组件)的接口称COM接口

COM component(COM组件)

COM中的接口是一组由组件实现的提供给客户使用的函数。

每一个COM接口都派生于IUnknown。这个名字有点误导人,其中没有未知(Unknown)接口的意思。它的原意是如果有一个指向某COM对象的IUnknown指针,就不用知道潜在的对象是什么,因为每个COM对象都实现IUnknown。

IUnknown 有三个方法:

AddRef() —— 通知COM对象增加它的引用计数。如果你进行了一次接口指针的拷贝,就必须调用一次这个方法,并且原始的值和拷贝的值两者都要用到。在本文的例子中没有用到AddRef()方法;

Release() —— 通知COM对象减少它的引用计数。参见前面的Release()示例代码段;

QueryInterface() —— 从COM对象请求一个接口指针。当coclass实现一个以上的接口时,就要用到这个方法;

前面已经看到了Release()的使用,但如何使用QueryInterface()呢?当你用CoCreateInstance()创建对象的时候,你得到一个返回的接口指针。如果这个COM对象实现一个以上的接口(不包括IUnknown),你就必须用QueryInterface()方法来获得任何你需要的附加的接口指针。

QueryInterface()的原型如下:

HRESULT IUnknown::QueryInterface ( REFIID iid, void** ppv )以下是参数解释:iid:所请求的接口的IID。ppv:接口指针的地址,QueryInterface()通过这个参数在成功时返回这个接口。

让我们继续外壳链接的例子。它实现了IShellLink 和IPersistFile接口。如果你已经有一个IShellLink指针,pISL,可以从COM对象请求IPersistFile接口:

HRESULT hrIPersistFile* pIPF

hr = pISL->QueryInterface ( IID_IPersistFile, (void**) &pIPF )

然后使用SUCCEEDED宏检查hr的值以确定QueryInterface()的调用情况,如果成功的话你就可以象使用其它接口指针那样使用新的接口指针,pIPF。但必须记住调用pIPF->Release()通知COM对象已经用完这个接口。仔细做好串处理 ,这一部分将花点时间来讨论如何在COM代码中处理串。如果你熟悉Unicode 和ANSI,并知道如何对它们进行转换的话,你就可以跳过这一部分,否则还是读一下这一部分的内容。

不管什么时候,只要COM方法返回一个串,这个串都是Unicode串(这里指的是写入COM规范的所有方法)。Unicode是一种字符编码集,类似ASCII,但用两个字节表示一个字符。如果你想更好地控制或 *** 作串的话,应该将它转换成TCHAR类型串。

TCHAR和以_t开头的函数(如_tcscpy())被设计用来让你用相同的源代码处理Unicode和ANSI串。在大多数情况下编写的代码都是用来处理ANSI串和ANSI WindowsAPIs,所以在下文中,除非另外说明,我所说的字符/串都是指TCHAR类型。你应该熟练掌握TCHAR类型,尤其是当你阅读其他人写的有关代码时,要特别注意TCHAR类型。

当你从某个COM方法返回得到一个Unicode串时,可以用下列几种方法之一将它转换成char类型串:

调用 WideCharToMultiByte() API;

调用CRT 函数wcstombs();

使用CString 构造器或赋值 *** 作(仅用于MFC );

使用ATL 串转换宏;

WideCharToMultiByte()你可以用WideCharToMultiByte()将一个Unicode串转换成一个ANSI串。此函数的原型如下: intWideCharToMultiByte(UINTCodePage,DWORDdwFlags,LPCWSTRlpWideCharStr,intcchWideChar,LPSTRlpMultiByteStr,intcbMultiByte,LPCSTRlpDefaultChar,LPBOOLlpUsedDefaultChar)以下是参数解释:CodePage:Unicode字符转换成的代码页。你可以传递CP_ACP来使用当前的ANSI代码页。代码页是256个字符集。字符0——127与ANSI编码一样。字符128——255与ANSI字符不同,它可以包含图形字符或者读音符号。每一种语言或地区都有其自己的代码页,所以使用正确的代码页对于正确地显示重音字符很重要。

dwFlags:dwFlags 确定Windows如何处理“复合” Unicode字符,它是一种后面带读音符号的字符。

如è就是一个复合字符。如果这些字符在CodePage参数指定的代码页中,不会出什么事。

否则,Windows必须对之进行转换。传递WC_COMPOSITECHECK使得这个API检查非映射复合字符。

传递WC_SEPCHARS使得Windows将字符分为两段,即字符加读音,如e`。

传递WC_DISCARDNS使得Windows丢弃读音符号。

传递WC_DEFAULTCHAR使得Windows用lpDefaultChar参数中说明的缺省字符替代复合字符。

缺省行为是WC_SEPCHARS。

lpWideCharStr 要转换的Unicode串。

cchWideChar lpWideCharStr在Unicode 字符中的长度。通常传递-1,表示这个串是以0x00结尾。

lpMultiByteStr 接受转换的串的字符缓冲cbMultiByte lpMultiByteStr的字节大小。

lpDefaultChar 可选——当dwFlags包含WC_COMPOSITECHECK | WC_DEFAULTCHAR并且某个Unicode字符不能被映射到同等的ANSI串时所传递的一个单字符ANSI串,包含被插入的“缺省”字符。可以传递NULL,让API使用系统缺省字符(一种写法是一个问号)。

lpUsedDefaultChar 可选——指向BOOL类型的一个指针,设置它来表示是否缺省字符曾被插入ANSI串。可以传递NULL来忽略这个参数。

我自己都有点晕菜了……!,万事开头难啊……,不搞清楚这些东西就很难搞清楚COM的串处理。何况文档中列出的比实际应用的要复杂得 多。下面就给出了如何使用这个API的例子: //假设已经有了一个Unicode串wszSomeString...charszANSIString[MAX_PATH]WideCharToMultiByte(CP_ACP,//ANSI代码页WC_COMPOSITECHECK,//检查重音字符wszSomeString,//原Unicode串-1,//-1意思是串以0x00结尾szANSIString,//目的char字符串sizeof(szANSIString),//缓冲大小NULL,//肥缺省字符串NULL)//忽略这个参数wcstombs()这个CRT函数是WideCharToMultiByte()的简化版,但它总结了WideCharToMultiByte()的调用,所以最终结果是一样的。

其原型如下: size_twcstombs(char*mbstr,constwchar_t*wcstr,size_tcount)以下是参数解释:

mbstr:接受结果ANSI串的字符(char)缓冲。

wcstr:要转换的Unicode串。

count:mbstr参数所指的缓冲大小。

wcstombs()在它对WideCharToMultiByte()的调用中使用WC_COMPOSITECHECK | WC_SEPCHARS标志。用wcstombs()转换前面例子中的Unicode串,结果一样:

wcstombs ( szANSIString, wszSomeString, sizeof(szANSIString) )

CString MFC中的CString包含有构造函数和接受Unicode串的赋值 *** 作,所以你可以用CString来实现转换。例如:

// 假设有一个Unicode串

wszSomeString...

CString str1 ( wszSomeString )// 用构造器转换

CString str2

str2 = wszSomeString// 用赋值 *** 作转换ATL宏

ATL有一组很方便的宏用于串的转换。W2A()用于将Unicode串转换为ANSI串(记忆方法是“wide to ANSI”——宽字符到ANSI)。实际上使用OLE2A()更精确,“OLE”表示的意思是COM串或者OLE串。下面是使用这些宏的例子: #include<atlconv.h>//还是假设有一个Unicode串wszSomeString...{charszANSIString[MAX_PATH]USES_CONVERSION//声明这个宏要使用的局部变量lstrcpy(szANSIString,OLE2A(wszSomeString))}OLE2A()宏“返回”转换的串的指针,但转换的串被存储在某个临时栈变量中,所以要用lstrcpy()来获得自己的拷贝。其它的几个宏是W2T()(Unicode 到 TCHAR)以及W2CT()(Unicode到常量TCHAR串)。

有个宏是OLE2CA()(Unicode到常量char串),可以被用到上面的例子中,OLE2CA()实际上是个更正宏,因为lstrcpy()的第二个参数是一个常量char*,关于这个问题本文将在以后作详细讨论。

另一方面,如果你不想做以上复杂的串处理,尽管让它还保持为Unicode串,如果编写的是控制台应用程序,输出/显示Unicode串时应该用全程变量std::wcout,如:wcout <<wszSomeString

但是要记住,std::wcout只认Unicode,所以你要是“正常”串的话,还得用std::cout输出/显示。

对于Unicode串文字量,要使用前缀L标示,如:

wcout <<LThe Oracle says... <<endl <<wszOracleResponse

如果保持串为Unicode,编程时有两个限制:

必须使用wcsXXX() Unicode串处理函数,如wcslen();

在Windows 9x环境中不能在Windows API中传递Unicode串。要想编写能在9x和NT上都能运行的应用,必须使用TCHAR类型,详情请参考MSDN;

用例子代码总结上述内容下面用两个例子演示本文所讲的COM概念。代码中还包含了本文的例子工程。

使用单接口COM对象

第一个例子展示的是单接口COM对象。这可能是你碰到得最简单的例子。它使用外壳中的活动桌面组件对象类(CLSID_ActiveDesktop)来获得当前桌面墙纸的文件名。请确认系统中安装了活动桌面(Active Desktop)。以下是编程步骤:

初始化COM库。 (Initialize);

创建一个与活动桌面交互的COM对象,并取得IActiveDesktop接口;

调用COM对象的GetWallpaper()方法;

如果GetWallpaper()成功,则输出/显示墙纸文件名;

释放接口(Release());

收回COM库(Uninitialize); WCHARwszWallpaper[MAX_PATH]CStringstrPathHRESULThrIActiveDesktop*pIAD//1.初始化COM库(让Windows加载DLLs)。通常是在程序的InitInstance()中调用//CoInitialize(NULL)或其它启动代码。MFC程序使用AfxOleInit()。CoInitialize(NULL)//2.使用外壳提供的活动桌面组件对象类创建COM对象。//第四个参数通知COM需要什么接口(这里是IActiveDesktop).hr=CoCreateInstance(CLSID_ActiveDesktop,NULL,CLSCTX_INPROC_SERVER,IID_IActiveDesktop,(void**)&pIAD)if(SUCCEEDED(hr)){//3.如果COM对象被创建成功,则调用这个对象的GetWallpaper()方法。hr=pIAD->GetWallpaper(wszWallpaper,MAX_PATH,0)if(SUCCEEDED(hr)){//4.如果GetWallpaper()成功,则输出它返回的文件名字。//注意这里使用wcout来显示Unicode串wszWallpaper.wcout是//Unicode专用,功能与cout.相同。wcout<<LWallpaperpathis:\n<<wszWallpaper<<endl<<endl}else{cout<<_T(GetWallpaper()failed.)<<endl<<endl}//5.释放接口。pIAD->Release()}else{cout<<_T(CoCreateInstance()failed.)<<endl<<endl}//6.收回COM库。MFC程序不用这一步,它自动完成。CoUninitialize()在这个例子中,输出/显示Unicode 串 wszWallpaper用的是std::wcout。使用多接口的COM对象

第二个例子展示了如何使用一个提供单接口的COM对象QueryInterface()函数。其中的代码用外壳的Shell Link组件对象类创建我们在第一个例子中获得的墙纸文件的快捷方式 。

以下是编程步骤:

初始化 COM 库;

创建一个用于建立快捷方式的COM 对象并取得IShellLink 接口;

调用IShellLink 接口的SetPath()方法;

调用对象的QueryInterface()函数并取得IPersistFile接口;

调用IPersistFile 接口的Save()方法;

释放接口;

收回COM库;

CString sWallpaper = wszWallpaper

//将墙纸路径转换为ANSII

ShellLink* pISL

IPersistFile* pIPF

// 1. 初始化COM库(让Windows 加载DLLs). 通常在InitInstance()中调用

// CoInitialize ( NULL )或其它启动代码。MFC 程序使用AfxOleInit() 。

CoInitialize ( NULL )

//2. 使用外壳提供的Shell Link组件对象类创建COM对象。.

// 第四个参数通知COM 需要什么接口(这里是IShellLink)。

hr = CoCreateInstance ( CLSID_ShellLink,

NULL,

CLSCTX_INPROC_SERVER,

IID_IShellLink,

(void**) &pISL )

if ( SUCCEEDED(hr) )

{

// 3. 设置快捷方式目标(墙纸文件)的路径。

hr = pISL->SetPath ( sWallpaper )

if ( SUCCEEDED(hr) )

{

// 4. 获取这个对象的第二个接口(IPersistFile)。

hr = pISL->QueryInterface ( IID_IPersistFile, (void**) &pIPF )

if ( SUCCEEDED(hr) )

{

// 5. 调用Save() 方法保存某个文件得快捷方式。第一个参数是

// Unicode 串。

hr = pIPF->Save ( LC:\\wallpaper.lnk, FALSE )

// 6a. 释放IPersistFile 接口。

pIPF->Release()

}

}

// 6. 释放IShellLink 接口。

pISL->Release()

}

// 输出错误信息部分这里省略。

// 7. 收回COM 库。MFC 程序不用这一步,它自动完成。

CoUninitialize()


欢迎分享,转载请注明来源:内存溢出

原文地址:https://54852.com/yw/11518147.html

(0)
打赏 微信扫一扫微信扫一扫 支付宝扫一扫支付宝扫一扫
上一篇 2023-05-16
下一篇2023-05-16

发表评论

登录后才能评论

评论列表(0条)

    保存