Класс КатлмодулетCAtlModuleT Class

Этот класс реализует модуль ATL.This class implements an ATL module.

СинтаксисSyntax

template <class T>
class ATL_NO_VTABLE CAtlModuleT : public CAtlModule

ПараметрыParameters

TT
Класс, производный от CAtlModuleT .Your class derived from CAtlModuleT.

ЭлементыMembers

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

nameName ОписаниеDescription
Катлмодулет:: КатлмодулетCAtlModuleT::CAtlModuleT Конструктор.The constructor.

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

nameName ОписаниеDescription
Катлмодулет:: ИнитлибидCAtlModuleT::InitLibId Инициализирует элемент данных, содержащий идентификатор GUID текущего модуля.Initializes the data member containing the GUID of the current module.
Катлмодулет:: РегистераппидCAtlModuleT::RegisterAppId Добавляет EXE в реестр.Adds the EXE to the registry.
Катлмодулет:: РегистерсерверCAtlModuleT::RegisterServer Добавляет службу в реестр.Adds the service to the registry.
Катлмодулет:: УнрегистераппидCAtlModuleT::UnregisterAppId Удаляет исполняемый файл из реестра.Removes the EXE from the registry.
Катлмодулет:: УнрегистерсерверCAtlModuleT::UnregisterServer Удаляет службу из реестра.Removes the service from the registry.
Катлмодулет:: УпдатерегистряппидCAtlModuleT::UpdateRegistryAppId Обновляет сведения о EXE в реестре.Updates the EXE information in the registry.

КомментарииRemarks

CAtlModuleT, производный от катлмодуле, реализует исполняемый (exe) или сервисный (exe) модуль ATL.CAtlModuleT, derived from CAtlModule, implements an Executable (EXE) or a Service (EXE) ATL module. Исполняемый модуль — это локальный сервер вне процесса, в то время как модуль службы — это приложение Windows, которое запускается в фоновом режиме при запуске Windows.An Executable module is a local, out-of-process server, whereas a Service module is a Windows application that runs in the background when Windows starts.

CAtlModuleT обеспечивает поддержку инициализации, регистрации и отмены регистрации модуля.CAtlModuleT provides support for initializing, registering, and unregistering of the module.

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

_ATL_MODULE_ATL_MODULE

катлмодулеCAtlModule

CAtlModuleT

ТребованияRequirements

Заголовок: atlbase. hHeader: atlbase.h

Катлмодулет:: КатлмодулетCAtlModuleT::CAtlModuleT

Конструктор.The constructor.

CAtlModuleT() throw();

КомментарииRemarks

Вызывает катлмодулет:: инитлибид.Calls CAtlModuleT::InitLibId.

Катлмодулет:: ИнитлибидCAtlModuleT::InitLibId

Инициализирует элемент данных, содержащий идентификатор GUID текущего модуля.Initializes the data member containing the GUID of the current module.

static void InitLibId() throw();

КомментарииRemarks

Вызывается конструктором катлмодулет:: катлмодулет.Called by the constructor CAtlModuleT::CAtlModuleT.

Катлмодулет:: РегистераппидCAtlModuleT::RegisterAppId

Добавляет EXE в реестр.Adds the EXE to the registry.

HRESULT RegisterAppId() throw();

Возвращаемое значениеReturn Value

Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.Returns S_OK on success, or an error HRESULT on failure.

Катлмодулет:: РегистерсерверCAtlModuleT::RegisterServer

Добавляет службу в реестр.Adds the service to the registry.

HRESULT RegisterServer(
    BOOL bRegTypeLib = FALSE,
    const CLSID* pCLSID = NULL) throw();

ПараметрыParameters

брегтипелибbRegTypeLib
Значение TRUE, если библиотека типов должна быть зарегистрирована.TRUE if the type library is to be registered. Значение по умолчанию — FALSE.The default value is FALSE.

пклсидpCLSID
Указывает на идентификатор CLSID регистрируемого объекта.Points to the CLSID of the object to be registered. При значении NULL (значение по умолчанию) будут зарегистрированы все объекты в сопоставлении объектов.If NULL (the default value), all objects in the object map will be registered.

Возвращаемое значениеReturn Value

Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.Returns S_OK on success, or an error HRESULT on failure.

Катлмодулет:: УнрегистераппидCAtlModuleT::UnregisterAppId

Удаляет исполняемый файл из реестра.Removes the EXE from the registry.

HRESULT UnregisterAppId() throw();

Возвращаемое значениеReturn Value

Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.Returns S_OK on success, or an error HRESULT on failure.

Катлмодулет:: УнрегистерсерверCAtlModuleT::UnregisterServer

Удаляет службу из реестра.Removes the service from the registry.

HRESULT UnregisterServer(
    BOOL bUnRegTypeLib,
    const CLSID* pCLSID = NULL) throw();

ПараметрыParameters

бунрегтипелибbUnRegTypeLib
Значение TRUE, если для библиотеки типов также требуется отменить регистрацию.TRUE if the type library is also to be unregistered.

пклсидpCLSID
Указывает на CLSID объекта, регистрация которого будет отменена.Points to the CLSID of the object to be unregistered. Если NULL (значение по умолчанию), регистрация всех объектов в сопоставлении объектов будет отменена.If NULL (the default value), all objects in the object map will be unregistered.

Возвращаемое значениеReturn Value

Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.Returns S_OK on success, or an error HRESULT on failure.

Катлмодулет:: УпдатерегистряппидCAtlModuleT::UpdateRegistryAppId

Обновляет сведения о EXE в реестре.Updates the EXE information in the registry.

static HRESULT WINAPI UpdateRegistryAppId(BOOL /* bRegister*/) throw();

ПараметрыParameters

брегистерbRegister
Зарезервировано.Reserved.

Возвращаемое значениеReturn Value

Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.Returns S_OK on success, or an error HRESULT on failure.

См. также разделSee also

Класс КатлмодулеCAtlModule Class
Общие сведения о классахClass Overview
Классы модулейModule Classes