一、前言
咱們用 ATL 寫了一個簡單的 COM 組件,之所以說簡單,是因為在組件中,只實現了一個自定義(custom)的接口 IFun。當然如果想偷懶的話,我們可以把 200 個函數都加到這一個接口中, 果真如此的話,恐怕就沒有人喜歡使用我們這個組件了。一個組件既然可以提供多個接口,那麼我們在設計的時候,就應該按照函數的功能進行分類,把不同功能分類的函數用多個接口表現出來。這樣可以有如下的一些好處:
二、接口結構
1 import "oaidl.idl";
2 import "ocidl.idl";
3 [
4 object,
5 uuid(072EA6CA-7D08-4E7E-B2B7-B2FB0B875595),
6 helpstring("IMathe Interface"),
7 pointer_default(unique)
8 ]
9 interface IMathe : IUnknown
10 {
11 [helpstring("method Add")] HRESULT Add([in] long n1, [in] long n2, [out,retval] long *pnVal);
12 };
13 [
14 uuid(CD7672F7-C0B4-4090-A2F8-234C0062F42C),
15 version(1.0),
16 helpstring("Simple3 1.0 Type Library")
17 ]
18 library SIMPLE3Lib
19 {
20 importlib("stdole32.tlb");
21 importlib("stdole2.tlb");
22 [
23 uuid(C6F241E2-43F6-4449-A024-B7340553221E),
24 helpstring("Mathe Class")
25 ]
26 coclass Mathe
27 {
28 [default] interface IMathe;
29 };
30 };
1-2
引入 IUnknown 和ATL已經定義的其它接口描述文件。import 類似與 C 語言中的 #include
3-12
一個接口的完整描述
4
object 表示本塊描述的是一個接口。IDL文件是借用了PRC遠程數據交換格式的說明方法
5
uuid(......) 接口的 IID,這個值是 ATL 自動生成的,可以手工修改或用 guidgen.exe 產生(注3)
6
在某些軟件或工具中,能看到這個提示
7
定義接口函數中參數所使用指針的默認屬性(注4)
9
接口叫 IMathe 派生自 IUnknown,於是 IMathe 接口的頭三個函數一定就是QueryInterface,AddRef和Release
10-12
接口函數列表
13-30
類型庫的完整描述(類型庫的概念以後再說),下面所說明的行,是需要先了解的
18
#import 時候的默認命名空間
23
組件的 CLSID,CoCreateInstance()的第一個參數就是它
27-29
接口列表
28
[default]表示誰提供了IUnknown接口import "oaidl.idl";
import "ocidl.idl";
[
object,
uuid(072EA6CA-7D08-4E7E-B2B7-B2FB0B875595),
helpstring("IMathe Interface"),
pointer_default(unique)
]
interface IMathe : IUnknown
{
[helpstring("method Add")] HRESULT Add([in] long n1, [in] long n2, [out,retval] long *pnVal);
};
[ // 所謂手工輸入,其實也是有技巧的:把上面的接口描述(IMathe)復制、粘貼下來,然後再改更方便哈
object, uuid(072EA6CB-7D08-4E7E-B2B7-B2FB0B875595),
// 手工或用工具產生的 IID
helpstring("IStr Interface"),
pointer_default(unique)
]
interface IStr : IUnknown
{
// 目前還沒有任何接口函數 }; [ uuid(CD7672F7-C0B4-4090-A2F8-234C0062F42C), version(1.0), helpstring("Simple3 1.0 Type Library")
]
library SIMPLE3Lib
{
importlib("stdole32.tlb"); importlib("stdole2.tlb");
[
uuid(C6F241E2-43F6-4449-A024-B7340553221E),
helpstring("Mathe Class")
]
coclass Mathe
{
[default] interface IMathe;
interface IStr; // 別忘了呦,這裡還有一個那
};
};
class ATL_NO_VTABLE CMathe :
public CComObjectRootEx <CComSingleThreadModel>,
public CComCoClass <CMathe, &CLSID_Mathe>,
public IMathe, // 別忘了,這裡加一個逗號
public IStr // 增加一個基類
{
public:
CMathe()
{
}
DECLARE_REGISTRY_RESOURCEID(IDR_MATHE)
DECLARE_PROTECT_FINAL_CONSTRUCT()
BEGIN_COM_MAP(CMathe) // 接口入口表。這裡填寫的接口,才能被QueryInterface()找到
COM_INTERFACE_ENTRY(IMathe)
COM_INTERFACE_ENTRY(IStr)
END_COM_MAP()
import "oaidl.idl";
import "ocidl.idl";
[
object,
uuid(072EA6CA-7D08-4E7E-B2B7-B2FB0B875595),
helpstring("IMathe Interface"),
pointer_default(unique)
]
interface IMathe : IUnknown
{
[helpstring("method Add")] HRESULT Add([in] long n1, [in] long n2, [out,retval] long *pnVal);
};
[ object,
uuid(072EA6CB-7D08-4E7E-B2B7-B2FB0B875595),
helpstring("IStr Interface"),
pointer_default(unique)
]
interface IStr : IUnknown
{
[helpstring("method Cat")] HRESULT Cat([in] BSTR s1, [in] BSTR s2, [out,retval] BSTR *psVal);
};
[
object,
uuid(072EA6CC-7D08-4E7E-B2B