一個COM組件在使用前必須首先注冊。所謂“注冊”,也就是向系統(tǒng)注冊表的相應位置寫入一些數(shù)據(jù)。這些數(shù)據(jù)可以完成guid與Dll的絕對路徑的一一對應,也就是說可以幫助程序通過guid找到Dll的位置。
GUID概念:
GUID(globally unique identifier)是一個128位的數(shù)。用于保證每一個接口和組件在時間和空間上都是全球唯一的一個標識符。為保證空間唯一性,根據(jù)機器上網(wǎng)卡的MAC地址再加上一定的算法生成的唯一的48位值序列;為保證時間上的唯一性,每個GUID值具有一個60位的時間戳。這個時間戳表示的是自1852年10月15號00:00:00以來以100納秒為時間間隔的計數(shù)值。這樣可以保證3400年GUID值仍然是唯一的。下面是GUID的定義和一個示例:
typedef struct _GUID {
unsigned long Data1;
unsigned short Data2;
unsigned short Data3;
unsigned char Data4[8];
} GUID;
// {364ede61-08ac-43ec-8861-15f5f9f4ced1}
微軟提供了兩個建立GUID的程序,一個時UUIDGEN.EXE,該程序是命令行方式的;另一個則是GUIDGEN.EXE,是一個示例性的VC++對話框應用。
DEFINE_GUID可以使用GUIDGEN.EXE來生成一個GUID。
注冊表:
組件可以用CLSID作為索引在Windows的注冊表中發(fā)布包含他們的DLL文件名稱。CoCreateInstance將用CLSID作為關鍵字在注冊表中查找所需要的文件名稱。注
冊表是一個由許多元素構成的層次結構。每一個元素均被稱作是一個關鍵字。每一個關鍵字可以包含一系列子關鍵字、一系列命名的值及/或一個未命名的值。COM只
使用了注冊表的一個分支:HKEY_CLASSES_ROOT;在此關鍵字之下,可以看到有一個CLSID關鍵字。在CLSID關鍵字之下列有系統(tǒng)中安裝的所有組件的CLSID。對于
每一個CLSID關鍵字,我們現(xiàn)在關心的只是它的一個子關鍵字InprocServer32。此子關鍵字的缺省值是組件所在的Dll文件路徑名稱。另一個子關鍵字ProgID指的是程序
員給某個CLSID指定的一個程序員易記的名稱。
如何注冊COM組件:
由于DLL知道它所包含的組件,因此DLL可以完成這些信息的注冊。在DLL中一定要處處如下兩個函數(shù):
DllRegisterServer();// 完成注冊組件
DllUnRegisterServer();// 完成反注冊組件
用戶可以使用程序REGSVR32.EXE來注冊某個組件。方法是使用命令行:regsvr32/u testDll.dll(反注冊) regsvr32 testDll.dll(注冊)。
一個典型的注冊COM組件Dll必須導出如下五個函數(shù):
1)DllMain:Dll的入口函數(shù),完成一些Dll的初始化工作(DirectShow實現(xiàn)的是DllEntryPoint);
2)DllGetClassObject:用于獲得類工廠指針;
3)DllCanUnloadNow: 系統(tǒng)空閑時會調(diào)用這個函數(shù),以確定是否可以卸載Dll;
4)DllRegisterServer:將COM組件注冊到注冊表中;
5)DllUnregisterServer: 刪除注冊表中COM組件的注冊信息。
所以,要想完成注冊,關鍵就是對DllRegisterServer();DllUnRegisterServer();兩個函數(shù)的實現(xiàn),下面將詳細介紹如何實現(xiàn)這兩個函數(shù):
//g_module為DLL的實例句柄
//CLSID_INNER_COM為組件的CLSID
//const char g_friend_name_inner [] = "inner_com_test";
//const char g_ver_indprog_id_inner [] = "inside.com.chapter.7.inner";
//const char g_prog_id_inner [] = "inside.com.chapter.7.inner.1";
STDAPI DllRegisterServer(void)
{
HRESULT hr = RegisterServer(g_module,CLSID_INNER_COM,
g_friend_name_inner,g_ver_indprog_id_inner,g_prog_id_inner);
return hr;
}
//Register the component in the registry
HRESULT RegisterServer(HMODULE hModule,
const CLSID& clsid,
const char* szFriendlyName,
const char* szVerIndProgID,
const char* szProgID)
{
//Get the Server location
char szModule[512];
DWORD dwResult = ::GetModuleFileName(hModule,szModule,sizeof(szModule)/sizeof(char));
assert(dwResult!=0);
//Convert the CLSID into a char
char szCLSID[CLSID_STRING_SIZE];
CLSIDtochar(clsid,szCLSID,sizeof(szCLSID));
//Build the key CLSID\\{}
char szKey[64];
strcpy(szKey,"CLSID\\");
strcat(szKey,szCLSID);
//Add the CLSID to the registry
setKeyAndValue(szKey,NULL,szFriendlyName);
//Add the Server filename subkey under the CLSID key
setKeyAndValue(szKey,"InprocServer32",szModule);
setKeyAndValue(szKey,"ProgID",szProgID);
setKeyAndValue(szKey,"VersionIndependentProgID",szVerIndProgID);
//Add the version-independent ProgID subkey under HKEY_CLASSES_ROOT
setKeyAndValue(szVerIndProgID,NULL,szFriendlyName);
setKeyAndValue(szVerIndProgID,"CLSID",szCLSID);
setKeyAndValue(szVerIndProgID,"CurVer",szProgID);
//Add the versioned ProgID subkey under HKEY_CLASSES_ROOT
setKeyAndValue(szProgID,NULL,szFriendlyName);
setKeyAndValue(szProgID,"CLSID",szCLSID);
return S_OK;
}
STDAPI DllUnregisterServer(void)
{
HRESULT hr = UnRegisterServer(CLSID_INNER_COM,g_ver_indprog_id_inner,g_prog_id_inner);
return hr;
}
//Remove the component from the register
HRESULT UnRegisterServer(const CLSID& clsid, // Class ID
const char* szVerIndProgID, // Programmatic
const char* szProgID) // IDs
{
//Convert the CLSID into a char.
char szCLSID[CLSID_STRING_SIZE];
CLSIDtochar(clsid,szCLSID,sizeof(szCLSID));
//Build the key CLSID\\{}
char szKey[64];
strcpy(szKey,"CLSID\\");
strcat(szKey,szCLSID);
//Delete the CLSID key - CLSID\{}
LONG lResult = recursiveDeleteKey(HKEY_CLASSES_ROOT,szKey);
assert((lResult == ERROR_SUCCESS) || (lResult == ERROR_FILE_NOT_FOUND));
//Delete the version-independent ProgID Key
lResult = recursiveDeleteKey(HKEY_CLASSES_ROOT,szVerIndProgID);
assert((lResult == ERROR_SUCCESS) || (lResult == ERROR_FILE_NOT_FOUND));
//Delete the ProgID key.
lResult = recursiveDeleteKey(HKEY_CLASSES_ROOT,szProgID);
assert((lResult == ERROR_SUCCESS) || (lResult == ERROR_FILE_NOT_FOUND));
return S_OK;
}