CAtlBaseModule 類別

這個類別會在每個 ATL 專案中具現化。

語法

class CAtlBaseModule : public _ATL_BASE_MODULE

成員

公用建構函式

名稱	描述
CAtlBaseModule：：CAtlBaseModule	建構函式。

公用方法

名稱	描述
CAtlBaseModule：：AddResourceInstance	將資源實例新增至預存控制碼清單。
CAtlBaseModule：：GetHInstanceAt	傳回指定之資源實例的控制碼。
CAtlBaseModule：：GetModuleInstance	從 CAtlBaseModule 物件傳回模組實例。
CAtlBaseModule：：GetResourceInstance	從 CAtlBaseModule 物件傳回資源實例。
CAtlBaseModule：：RemoveResourceInstance	從預存控制碼清單中移除資源實例。
CAtlBaseModule：：SetResourceInstance	設定 物件的資源實例 CAtlBaseModule 。

公用資料成員

名稱	描述
CAtlBaseModule：：m_bInitFailed	變數，指出模組初始化是否失敗。

備註

每個 ATL 專案中都有具名_AtlBaseModule的實例，其中包含模組實例的 CAtlBaseModule 控制碼、包含資源的模組控制碼（預設為一個和相同），以及提供主要資源的模組控制碼陣列。 CAtlBaseModule 可以從多個執行緒安全地存取。

此類別會取代舊版 ATL 中使用的過時 CComModule 類別。

繼承階層架構

_ATL_BASE_MODULE

CAtlBaseModule

需求

標頭： atlcore.h

CAtlBaseModule：：AddResourceInstance

將資源實例新增至預存控制碼清單。

bool AddResourceInstance(HINSTANCE hInst) throw();

參數

hInst
要加入的資源實例。

傳回值

如果已成功新增資源，則傳回 true，否則傳回 false。

CAtlBaseModule：：CAtlBaseModule

建構函式。

CAtlBaseModule() throw();

備註

建立 CAtlBaseModule。

CAtlBaseModule：：GetHInstanceAt

傳回指定之資源實例的控制碼。

HINSTANCE GetHInstanceAt(int i) throw();

參數

i
資源實例的數目。

傳回值

傳回資源實例的控制碼，如果沒有對應的資源實例，則傳回 Null。

CAtlBaseModule：：GetModuleInstance

從 CAtlBaseModule 物件傳回模組實例。

HINSTANCE GetModuleInstance() throw();

傳回值

傳回模組實例。

CAtlBaseModule：：GetResourceInstance

傳回資源實例。

HINSTANCE GetResourceInstance() throw();

傳回值

傳回資源實例。

CAtlBaseModule：：m_bInitFailed

變數，指出模組初始化是否失敗。

static bool m_bInitFailed;

備註

如果模組初始化，則為 True;如果模組無法初始化，則為 false。

CAtlBaseModule：：RemoveResourceInstance

從預存控制碼清單中移除資源實例。

bool RemoveResourceInstance(HINSTANCE hInst) throw();

參數

hInst
要移除的資源實例。

傳回值

如果已成功移除資源，則傳回 true，否則傳回 false。

CAtlBaseModule：：SetResourceInstance

設定 物件的資源實例 CAtlBaseModule 。

HINSTANCE SetResourceInstance(HINSTANCE hInst) throw();

參數

hInst
新的資源實例。

傳回值

傳回更新的資源實例。

另請參閱

類別概觀
模組類別