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
要求
标头：atlcom.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
新资源实例。
返回值
返回更新的资源实例。