用C實現的一個基本COM接口IFoo（來自COM Programmer's Cookbook）
把該文中實現的代碼整理匯總到一個項目中。目前只是實現到一個中間階段，重點在說明COM接口的實現原理，還沒有包含類廠的部分。以后還需陸續添加類廠等高級功能。
文件組成：
ifoo.h COM接口IFoo,接口ID IID_IFoo 聲明文件。
outside.c COM接口實現。這里實現IFoo的是一個結構體COutside.
util.h 一些宏定義、全局函數、變量聲明文件。
main.c 筆者為實現項目添加的文件。提供main函數、內存管理函數Alloc,Free的實現（封裝C運行庫函數malloc和free.）、接口ID定義。
COM接口到底是什么？
COM接口是一個指向虛函數表的指針。通過這個指針可以訪問內存中某處的各個功能塊，執行預定義的功能，完成用戶的任務。這些功能塊以函數的形式存在（想不出還有其他形式:)）并被調用。它們有一個共同點：都包含一個指針參數，指向這些功能要操作的數據地址。在C++中，這個地址就是對象的首地址，也就是類成員函數中隱含的this指針。在C函數中并沒有這種現成的便利，因此代碼實現中在接口定義時仍使用了接口指針（HRESULT (__stdcall * QueryInterface) (IFoo * This, const IID * const, void **)），而在接口函數實現時根據結構體布局結構，從這個接口指針推算得到對象實例指針。
typedef struct IFoo
{
struct IFooVtbl * lpVtbl;
} IFoo;
typedef struct IFooVtbl IFooVtbl;
struct IFooVtbl
{
HRESULT (__stdcall * QueryInterface) (IFoo * This, const IID * const, void **) ;
ULONG (__stdcall * AddRef) (IFoo * This) ;
ULONG (__stdcall * Release) (IFoo * This) ;
HRESULT (__stdcall * SetValue) (IFoo * This, int) ;
HRESULT (__stdcall * GetValue) (IFoo * This, int *) ;
};
COM接口的要求：
每一個COM接口（指向的虛函數表）的頭三個函數必須是IUnknown接口的函數：QueryInterface,AddRef和Release。在C++中，稱為從IUnknown接口繼承。
對于調用QueryInterface響應查詢IID_IUnknwon得到的接口指針值，同一個對象實現的所有接口必須相同。這是判斷兩個COM對象是否是同一個對象的標準。
宏定義“#define IUNK_VTABLE_OF(x) ((IUnknownVtbl *)((x)->lpVtbl))“說明
在預處理輸出文件main.i中可以找到IUnknownVtbl和IFooVtbl的聲明：
typedef struct IUnknownVtbl
{
HRESULT ( __stdcall *QueryInterface )(
IUnknown * This,
const IID * const riid,
void **ppvObject);
ULONG ( __stdcall *AddRef )(
IUnknown * This);
ULONG ( __stdcall *Release )(
IUnknown * This);
} IUnknownVtbl;
struct IUnknown
{
struct IUnknownVtbl *lpVtbl;
};
struct IFooVtbl
{
HRESULT (__stdcall * QueryInterface) (IFoo * This, const IID * const, void **) ;
ULONG (__stdcall * AddRef) (IFoo * This) ;
ULONG (__stdcall * Release) (IFoo * This) ;
HRESULT (__stdcall * SetValue) (IFoo * This, int) ;
HRESULT (__stdcall * GetValue) (IFoo * This, int *) ;
};
該宏定義的作用就是把IFoo接口中的IFooVtbl類型的指針拿出來（(x)->lpVtbl)），并強制轉換（(IUnknownVtbl *)）成IUnknownVtbl。
“強制轉換”的結果是什么呢？是怎么做到的呢？
很明顯，結果就是得到的指針不再是IFooVtbl *類型，而是變成了IUnknownVtbl *類型。至于做法，系統應該記錄每一個變量、表達式的類型。當進行強制類型轉換時，就（臨時地）修改其類型為轉換到的類型。
同理，QueryInterface, AddRef, Release宏定義中的(IUnknown *)也是這種用法。
可以看到，宏“IUNK_VTABLE_OF“的作用是供宏QueryInterface,宏AddRef，宏Release引用，把IFooVtbl *類型轉換為IUnknownVtbl *類型，最終達到調用IUnknownVtbl中定義的三個QueryInterface,AddRef,Release函數。
那么，這種大費周章的目的是什么呢？為什么不以IFooVtbl中三個函數的定義形式（不通過強制轉換來轉換成必須的類型），直接調用IFooVtbl中定義的函數呢？雖然強制轉換在參數值上并不會造成改變，最終調用的也是IFooVtbl定義的函數（FooQueryInterface,FooAddRef,FooRelease）。
為什么一定要通過IUnknown接口指針調用這三個函數呢？修改QueryInterface宏定義如下：
#define QueryInterface(pif, iid, pintf) \
(((pif)->lpVtbl)->QueryInterface(pif, iid, (void **)(pintf)))
即通過IFoo接口指針來調用由IUnknown引入的函數，有什么不對的地方嗎？
試驗表明，將QueryInterface宏定義如下也可以編譯通過，執行起來也沒有出現任何異常。
#define QueryInterface(pif, iid, pintf) \
(((pif)->lpVtbl)->QueryInterface(pif, iid, (void **)(pintf)))
對于IUnknown接口的三個函數，調用時傳遞的參數是IUnknown *類型（見QueryInterface, AddRef, Release宏定義），而函數定義中（FooQueryInterface, FooAddRef, FooRelease）聲明的參數是IFoo *類型，這種不一致的情況是怎么出現的？這種不一致不會有問題嗎？
這種不一致的產生是由于從不同的角度看待引起的。如果從IUnknown接口來看，那么接口函數中的第一個參數類型就是IUnknown *;如果從IFoo來看，那么第一個參數的類型就是IFoo *。
這種不一致性只是針對于編譯器對于類型的編譯要求有意義的，在接口實現及使用時，傳遞給lpVtbl->QueryInterface, lpVtbl->AddRef,lpVtbl->Release的第一個參數在值上都是相同的，都是實現該接口的內存地址（在本例中是COutside對象的首地址）。
一些語法現象回顧
函數指針變量定義、賦值及調用。
HRESULT (__stdcall * pQI) (IFoo * This, const IID * const, void **) ;
定義一個函數指針變量pQI,該變量指向“返回HRESULT,取3個參數分別為類型IFoo *,const IID * const, void **”的函數。
typedef HRESULT (__stdcall * QIType) (IFoo * This, const IID * const, void **) ;
定義一個函數指針類型，該類型的指針指向“返回HRESULT,取3個參數分別為類型IFoo *,const IID * const, void **”的函數。
HRESULT __stdcall QueryInterface(IFoo * This, const IID * const, void **) ;//函數聲明示例
pQI = 0; // 函數指針賦值，0表示不指向任何函數。
pQI = QueryInterface; // 函數指針賦值，pQI指向QueryInterface。
pQI = &QueryInterface; // 與上面等價。
QueryInterface(&this->ifoo, riid, ppv); // 使用函數名直接調用
pQI(&this->ifoo, riid, ppv); // 函數指針調用
(*pQI)(&this->ifoo, riid, ppv); // 第二種函數指針調用方式
宏定義、展開規則
對于宏，一直有一種霧里看花的感覺，似乎很隨意，怎么來都行，比如：
#define AddRef(pif) \
(IUNK_VTABLE_OF(pif)->AddRef((IUnknown *)(pif)))
宏定義應該是可以嵌套的，即宏定義的“內容“中還可以包含（嵌套）宏，如本例，“IUNK_VTABLE_OF”就是嵌套宏。在展開的時候，將嵌套的宏也一并展開（替換成定義的內容），直到不再有宏為止。
那么就有兩個疑問：
1。如果被嵌套的宏包含（直接或間接）定義的宏，那么展開就沒完沒了，死循環了。
2。如果定義的內容中有跟定義的宏同名的字符串（比如上面的例子IUNK_VTABLE_OF），那么怎么區分這同名的東東是嵌套的宏（需要展開），還是一般的字符串（不需要展開）？
函數調用規范約定、main函數調用規范。
一開始把幾個文件匯總到項目里時，編譯通不過，錯誤提示大致意思是，不能把一種調用規范的函數指針轉換成另一種調用規范的函數指針。后來把調用規范改為 /Gz(__stdcall),編譯為（Compile As）改為/TC(Compile As C Code)就好了。
想來是對于.c文件，編譯器缺省使用的是__cdecl，而IFoo中的接口宏定義在win32下展開成了__stdcall，所以出現了矛盾。而使用/Gz強制未聲明調用規范的函數使用__stdcall，實現就與聲明一致了。
(size_t)&(((s *)0)->m)
c++程序員也許都知道，訪問地址“0”處的成員是一大忌，會造成GP。然而，取地址“0”處的成員的地址，卻是個合法的操作。雖然地址“0”處并沒有什么內容，但是，如果在地址0處存放一個內容，那么該內容中的成員也是有地址的。本例中正是巧妙地利用這種方法，從接口地址計算得出實現該接口的實例地址，進而訪問實例的內部變量。
------------------------------------------------------------------------------------
2009年5月6日
附上源碼：/Files/gracelee/outside.zip
代碼執行結果：
在C實現COM接口系列1中實現的com接口IFoo與使用它的客戶耦合在一起，沒有實現在各自分離的模塊，因此不符合模塊化編程思想。本期添加類廠支持，以使接口的實現與接口的使用相分離。
---------------------------------------------------
類廠的作用到底是什么？
將接口的實現與客戶使用分離開來嗎？
不盡然。使用CoCreateInstance，客戶可以完全不必知道類廠的存在，而創建組件，獲取組件實現的接口并使用。
即COM庫可以完全拋開類廠的概念，而是提供一個這樣的函數原型：
CoCreateObject(REFID rclsid,...,REFID riid,void **ppItf);
用戶在調用的時候可以對riid提供IID_Unknown或者特定于該對象的一個接口，直接獲取該對象的IUnknown或特定的接口指針。
可以看到，這正是CoCreateInstance所作的事情。
1 類廠提供了間接創建類對象的方式：用戶可以先獲取并持有類廠接口指針，通過該指針所指向的類廠接口創建類對象。適用于需要創建多個（或重復創建）類對象的地方，減少了每次都要定位對象庫并把對象庫裝入內存的開銷。
2 類廠提供了保證組件庫留在內存不被卸載出去的另一種方法：類廠接口函數LockServer。組件庫維護一個庫范圍計數器，只有該計數器為0時，組件庫才允許自己被卸載出內存。（與此相對，引用計數是類對象范圍的，通過該類實現的各個接口來維護。如果一個類對象的引用計數達到0，那么該對象占有的內存就被釋放，該對象上的接口指針也不再有效。）
除了調用LockServer鎖定組件庫以外，當創建的組件個數大于0時，組件庫也不能被卸載。也可以說，調用一次LockServer()的作用相當于創建了一個組件。
-----------------------------------------------------------------------
客戶一側：
1 使用一個接口需要知道哪些信息？
備選：
接口IID
類對象（類廠）CLSID（或ProgID）
接口函數原型（參數個數，類型，返回值）
實現接口組件的線程模型（進程內、進程外、遠程）？
類型庫typelib信息？
服務一側：
2 實現一個組件和接口以供客戶調用，需要提供哪些東西？
備選：
所有客戶使用組件和接口所需的內容
額外的還有：
--------------------------------------------------------------------
為dll添加.def文件與直接在需要導出的函數定義處指定_declspec( dllexport )有區別嗎？如果有是什么區別？
我發現在outdll.c中這樣指定：
__declspec( dllexport ) HRESULT DllGetClassObject (REFCLSID rclsid, REFIID riid, void **ppv)
會產生編譯錯誤：
1>------ Build started: Project: outside, Configuration: Debug Win32 ------
1>Compiling...
1>outdll.c
1>d:\outside-cf\outside\outdll.c(19) : error C2375: 'DllGetClassObject' : redefinition; different linkage
1> c:\program files\microsoft visual studio 8\vc\platformsdk\include\objbase.h(833) : see declaration of 'DllGetClassObject'
1>Build log was saved at "file://d:\outside-cf\outside\Debug\BuildLog.htm"
1>outside - 1 error(s), 0 warning(s)
========== Build: 0 succeeded, 1 failed, 1 up-to-date, 0 skipped ==========
c2375的解釋意思是出錯的函數使用的鏈接指示符與之前聲明的不同。
Compiler Error C2375
'function' : redefinition; different linkage
The function is already declared with a different linkage specifier.
objbase.h中聲明了DllGetClassObject()函數：
STDAPI DllGetClassObject(IN REFCLSID rclsid, IN REFIID riid, OUT LPVOID FAR* ppv);
而使用.def文件就沒有問題。
-----------------------------------------------------------------------------
初次執行結果：
問題就是總有一個分配的內存沒有釋放：
根據打印出來的內存地址可以判斷，應該是先創建的類廠對象的內存沒有釋放。
檢查代碼，main()中并沒有忘記調用Release(pCF)釋放類廠對象。打印Release(pCF)的返回值，發現是1，即在類廠接口指針上少調用了一次Release，那么，究竟是哪里少的呢？
main()函數中有關類廠對象引用計數的地方就是CoGetClassObject和Release（CreateInstance跟類廠自己的引用計數無關），這是一對增加引用計數和減少引用計數的對應操作，所以,main()中應該沒有問題。
那么，就只有創建類廠對象的時候了。下面看一下類廠對象是如何創建的。
首先，main調用CoGetClassObject，該函數就調用dll中的DllGetClassObject。由于是第一次調用（不考慮其他客戶使用該dll的情況），程序執行到CreateClassFactory(...),該函數執行完后，類廠對象的引用計數是1。
由于創建成功，因此繼續向下執行到QueryInterface,此時，類廠對象的引用計數變成了2。然后，DllGetClassObject返回，com庫函數CoGetClassObject也應該返回。注意，此時的類廠對象引用計數已經是2了！
因此，問題就出在這里。main調用一次CoGetClassObject后，類廠對象的引用計數是2，而不是我想向中的1。于是，后面調用一次Release也就當然無法釋放掉類場對象了。
1 HRESULT DllGetClassObject (REFCLSID rclsid, REFIID riid, void **ppv)
2 {
3 *ppv = 0;
4 if (IsEqualCLSID (rclsid, &CLSID_Outside))
5 {
6
7 if (!vpcfOutside)
8
9 {
10
11 HRESULT hr = CreateClassFactory (&CLSID_Outside, CreateOutside,
12 &IID_IClassFactory, &vpcfOutside);
13
14 if (hr != NOERROR)
15
16 return hr;
17 }
18
19 return QueryInterface (vpcfOutside, riid, ppv);
20
21 }
22
23 return E_FAIL;
24 }
找到了原因，改正就很容易了。這里我覺得需要把DllGetClassObject作如下修改：
1 HRESULT DllGetClassObject (REFCLSID rclsid, REFIID riid, void **ppv)
2 {
3 *ppv = 0;
4 if (IsEqualCLSID (rclsid, &CLSID_Outside))
5 {
6
7 if (!vpcfOutside)
8
9 {
10
11 HRESULT hr = CreateClassFactory (&CLSID_Outside, CreateOutside,
12 &IID_IClassFactory, &vpcfOutside);
13
14 if (hr != NOERROR)
15
16 return hr;
17
18 if(IsEqualIID(riid,&IID_IClassFactory))
19 {
20 *ppv = vpcfOutside;// Set *ppv to vpcfOutside directly instead of QueryInterface if first time creation
21 return NOERROR;
22 }
23 else
24 {
25 Release(vpcfOutside);// Any interface requested (riid) other than IID_ClassFactory and IID_Unknown not support by class factory,
26 // call Release to free the memory.
27 return E_FAIL;
28 }
29
30 }
31
32 return QueryInterface (vpcfOutside, riid, ppv);
33
34 }
35
36 return E_FAIL;
37 }
修改后在執行，內存都正常釋放了。
-------------------------------------------------------------------------------------------
CreateClassFactory代碼說明
1 HRESULT CreateClassFactory (REFCLSID rclsid,
2 HRESULT (*pfnCreate)(IUnknown *, REFIID, void **),
3 REFIID riid, void **ppv)
4 {
5 ClassFactory *this;
6 HRESULT hr;
7
8 *ppv = 0;
9 if (hr = Alloc (sizeof (ClassFactory), &this))
10 return hr;
11
12 this->icf.lpVtbl = &vtblClassFactory;
13 this->cRef = 1; // After this call, cRef==1
14
15 this->pfnCreate = pfnCreate;
16
17 hr = QueryInterface (&this->icf, riid, ppv); // After this call, cRef==2
18 Release (&this->icf); // Corresponds to "this->cRef = 1", ater this call, cRef==1
19
20 return hr;
21 }
可以看到，兩行代碼的效果是對引用計數增1及減1，這兩行代碼執行后，對引用計數的影響互相抵消，等于沒有改變引用計數。那么，把這兩行同時注釋掉，是不是可以呢？
我的回答是：在本例中可以。因為這兩行代碼之間的QueryInterface總是可以執行成功的（因為是用IDD_ClassFactory來調用該函數的）。所以，即便把這兩行代碼同時注釋掉，CreateClassFactory執行結束后，類廠對象的引用計數也增了1，以后調用Release就可以釋放掉類廠對象占用的內存。
但是，如果CFQueryInterface的代碼編寫中除了錯誤，比如，像這樣寫：
1 static HRESULT CFQueryInterface (IClassFactory *pcf, REFIID riid, void **ppv)
2 {
3 ClassFactory *this = IMPL (ClassFactory, icf, pcf);
4
5 if (IsEqualIID (riid, &IID_IUnknown) ||
6 // IsEqualIID (riid, &IID_IClassFactory)) // Comment out this condition to create an error
7 *ppv = &this->icf;
8 else
9 {
10 *ppv = 0;
11 return E_NOINTERFACE;
12 }
13
14 AddRef ((IClassFactory *)*ppv);
15
16 return NOERROR;
17 }
那么，這兩行代碼之間的QueryInterface就會執行出錯，那么類廠對象占用的內存就永遠沒有機會釋放了。
也就是說，AddRef和Release雖然在作用上對引用計數來說相互抵消，但Release函數提供了釋放對象內存的機會（當引用計數為0時），如果不成對的調用他們，也就失去了管理對象內存（釋放對象占用的內存）的機會。
---------------------------------------------------------------------------
組件庫outside文件說明：
IFoo.h IFoo接口聲明
outside.c 組件對象、IFoo接口實現
cf.c 類廠對象、IClassFactory接口實現
outdll.c 組件庫導出函數實現
outside.def 組件庫模塊定義文件，導出函數聲明
outside.reg 組件庫注冊文件
----------------------------------------------------------------------------
源碼： outside-cf