CAtlComModule 類別
這個類別會實作 COM 伺服器模組。
語法
class CAtlComModule : public _ATL_COM_MODULE
成員
公用建構函式
名稱 | 描述 |
---|---|
CAtlComModule::CAtlComModule | 建構函式。 |
CAtlComModule::~CAtlComModule | 解構函式。 |
公用方法
名稱 | 描述 |
---|---|
CAtlComModule::RegisterServer | 呼叫這個方法,以更新對象對應中每個物件的系統登錄。 |
CAtlComModule::RegisterTypeLib | 呼叫此方法以註冊類型連結庫。 |
CAtlComModule::UnregisterServer | 呼叫此方法以取消註冊對象對應中的每個物件。 |
CAtlComModule::UnRegisterTypeLib | 呼叫此方法以取消註冊類型庫。 |
備註
CAtlComModule
會實作 COM 伺服器模組,允許用戶端存取模組的元件。
此類別會取代舊版 ATL 中使用的過時 CComModule 類別。 如需詳細資訊,請參閱 ATL 模組類別。
繼承階層架構
CAtlComModule
需求
標頭: atlbase.h
CAtlComModule::CAtlComModule
建構函式。
CAtlComModule() throw();
備註
初始化模組。
CAtlComModule::~CAtlComModule
解構函式。
~CAtlComModule();
備註
釋放所有類別工廠。
CAtlComModule::RegisterServer
呼叫這個方法,以更新對象對應中每個物件的系統登錄。
HRESULT RegisterServer(BOOL bRegTypeLib = FALSE, const CLSID* pCLSID = NULL);
參數
bRegTypeLib
如果要註冊類型庫,則為TRUE。 預設值為 FALSE。
pCLSID
指向要註冊之物件的CLSID。 如果為 NULL(預設值),則會註冊對象對應中的所有物件。
傳回值
傳回成功時S_OK,或在失敗時傳回錯誤 HRESULT。
備註
呼叫全域函式 AtlComModuleRegisterServer。
CAtlComModule::RegisterTypeLib
呼叫此方法以註冊類型連結庫。
HRESULT RegisterTypeLib(LPCTSTR lpszIndex);
HRESULT RegisterTypeLib();
參數
lpszIndex
格式為 “\\N” 的字串,其中 N 是 TYPELIB 資源的整數索引。
傳回值
傳回成功時S_OK,或在失敗時傳回錯誤 HRESULT。
備註
將類型連結庫的相關信息新增至系統登錄。 如果模組實例包含多個類型連結庫,請使用這個方法的第一個版本來指定應該使用哪一個類型庫。
CAtlComModule::UnregisterServer
呼叫此方法以取消註冊對象對應中的每個物件。
HRESULT UnregisterServer(
BOOL bRegTypeLib = FALSE,
const CLSID* pCLSID = NULL);
參數
bRegTypeLib
如果要取消註冊類型庫,則為TRUE。 預設值為 FALSE。
pCLSID
指向要取消註冊之物件的CLSID。 如果為 NULL(預設值),則會取消註冊對象對應中的所有物件。
傳回值
傳回成功時S_OK,或在失敗時傳回錯誤 HRESULT。
備註
呼叫全域函式 AtlComModuleUnregisterServer。
CAtlComModule::UnRegisterTypeLib
呼叫此方法以取消註冊類型庫。
HRESULT UnRegisterTypeLib(LPCTSTR lpszIndex);
HRESULT UnRegisterTypeLib();
參數
lpszIndex
格式為 “\\N” 的字串,其中 N 是 TYPELIB 資源的整數索引。
備註
從系統登錄中移除類型庫的相關信息。 如果模組實例包含多個類型連結庫,請使用這個方法的第一個版本來指定應該使用哪一個類型庫。
傳回值
傳回成功時S_OK,或在失敗時傳回錯誤 HRESULT。