Класс CAtlComModule

Этот класс реализует модуль COM-сервера.

Синтаксис

class CAtlComModule : public _ATL_COM_MODULE

Участники

Открытые конструкторы

Имя	Описание
CAtlComModule::CAtlComModule	Конструктор.
CAtlComModule::~CAtlComModule	Деструктор

Открытые методы

Имя	Описание
CAtlComModule::RegisterServer	Вызовите этот метод, чтобы обновить системный реестр для каждого объекта на карте объектов.
CAtlComModule::RegisterTypeLib	Вызовите этот метод для регистрации библиотеки типов.
CAtlComModule::UnregisterServer	Вызовите этот метод для отмены регистрации каждого объекта на карте объектов.
CAtlComModule::UnRegisterTypeLib	Вызовите этот метод для отмены регистрации библиотеки типов.

Замечания

CAtlComModule реализует com-серверный модуль, позволяющий клиенту получать доступ к компонентам модуля.

Этот класс заменяет устаревший класс CComModule , используемый в более ранних версиях ATL. Дополнительные сведения см. в разделе "Классы модулей ATL".

Иерархия наследования

_ATL_COM_MODULE

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 при сбое.

См. также

_ATL_COM_MODULE
Общие сведения о классе