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 類別。
繼承階層架構
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
新的資源實例。
傳回值
傳回更新的資源實例。