共用方式為


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 模組類別。

繼承階層架構

_ATL_COM_MODULE

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。

另請參閱

_ATL_COM_MODULE
類別概觀