Класс 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".
Иерархия наследования
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 при сбое.