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

要求

标头：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
新资源实例。

返回值

返回更新的资源实例。

另请参阅

类概述
Module 类