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
類別概觀