在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 組件庫注冊文件