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 模块类。
继承层次结构
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。