用标准C编写COM(三)COMinplainC,Part3.docVIP

内容 ? ? 简介 ? ? 定义集合对象 ? ? 辅助函数 ? ? 我们集合对象的函数 ? ? 应用程序获得我们集合对象的方法 ? ? VBScript例程 ? ? C例程 ? ? IEnumVARIANT对象 ? ? 另一个VBScript例程 ? ? 另一个C例程 ? ? 一个更通用的方法 ? ? 添加、删除元素 简介 ? ? ? ?有时我们可能需要维护一个元素列表。例如，我们可能设计了一个COM组件用于操作我们设计的PCI硬件板卡，并且用户可以在一台计算机上安装几个这种板卡，我们要让我们的组件能控制所有可用的板卡，允许应用程序获得每块板卡的信息，同时可单独访问每块板卡。 ? ? ?换句话说，当我们组件运行时，它需要查询系统中的板卡，然后把所有可用板卡的信息的列表给应用程序。为了这点，假设我们只需要每块可用板卡的“名字”，系统中第一块板卡名字可能是“Port 1”,第二块板卡名字是“Port 2”,等等。 ? ? ?因为我们事先不知道系统中到底有多少块板卡，所以最好的方法是创建一个结构，它们可以链接同类其它成员成一个链表。例如我们可以定义一个IENUMITEM结构来保存板卡信息： [cpp]?view plaincopyprint? typedef?struct?_IENUMITEM?{?? //?To?link?several?IENUMITEMs?into?a?list.?? //?把多个IENUMITEM链接到一个列表中?? struct?_IENUMITEM?*next;?? //?This?items?value?(ie,?its?port?name).?? //?元素值（也就是它的端口名）?? char?*value;?? ?}IENUMITEM;?? ? ? ??如果我们有三个端口，我们的IENUMITEM链表看起来可以是这样（我们通常应该通过GlobalAlloc分配IENUMITEM，但为了省事我在下面把它们申明为静态的并初始化它们）： [cpp]?view plaincopyprint? IENUMITEM?Port1?=?{Port2,?Port?1};?? IENUMITEM?Port2?=?{Port3,?Port?2};?? IENUMITEM?Port3?=?{0,?Port?3};?? ? ? ?在COM术语中，我们把一组相关元素叫做“集合（collection）”。所以上面三个元素的链表就是我们的集合。 ? 但我们上面的IENUMITEM存在一个问题，它有一个char*成员，它不是自动化兼容类型。我们可以把它改为BSTR，这样它就是自动化兼容类型了。更好一点，我们可以放一个VARIANT在IENUMITEM中，这样做的优点是构造了一个通用的IENUMITEM（也就是说它可以存储各种自动化数据类型数据）。像我们稍后看到的，我们必须用VARIANT来返回元素的值给应用程序。因为我们总是要处理VARIANT类型数据，所以我们就把它定义为VARIANT存储在我们的IENUMITEM中。下面是IENUMITEM的新定义： [cpp]?view plaincopyprint? typedef?struct?_IENUMITEM?{?? ???struct?_IENUMITEM??*next;?? ???VARIANT????????????*value;?? ?}IENUMITEM;?? ? ? ?下面是我们如何分配一个实例并把它的值设置为“Port 1”（忽略错误检查）： [cpp]?view plaincopyprint? IENUMITEM??*enumItem;?? enumItem?=?(IENUMITEM?*)GlobalAlloc(GMEM_FIXED,?sizeof(IENUMITEM));?? enumItem-next?=?0;?? enumItem-value.vt?=?VT_BSTR;?? enumItem-value.bstrVal?=?SysAllocString(LPort?1);?? 定义集合对象 ? ? ? ?记得脚本语言没有指针概念。这些语言本身不可能遍历上面的列表，因为每个IENUMITEM的第一个成员是指向下一个IENUMITEM的指针。所以我们需要提供一个对象来帮助应用程序遍历这个列表，获取每个元素的值。 ? 因为微软应Visual Basic程序员提出这个对象，所以他们选择了它是基于IDispatch的。换句话说,我们对象的虚表必须像所有COM对象那样以三个IUnknown函数（QueryInterface、AddRef和Release）开始，后面必须紧跟四个标准的IDispatch函数（GetTypeInfoCount、GetTypeInfo、Ge