Classe CAtlModuleT

Essa classe implementa um módulo da ATL.

Sintaxe

template <class T>
class ATL_NO_VTABLE CAtlModuleT : public CAtlModule

Parâmetros

T
Sua classe derivada de CAtlModuleT.

Membros

Construtores públicos

Métodos públicos

Comentários

CAtlModuleT, derivado de CAtlModule, implementa um módulo da ATL executável (EXE) ou de serviço (EXE). Um módulo executável é um servidor local fora do processo, enquanto um módulo de serviço é um aplicativo do Windows executado em segundo plano quando o Windows é iniciado.

CAtlModuleT fornece suporte para inicialização, registro e cancelamento do registro do módulo.

Hierarquia de herança

_ATL_MODULE

CAtlModule

CAtlModuleT

Requisitos

Cabeçalho: atlbase.h

CAtlModuleT::CAtlModuleT

O construtor .

CAtlModuleT() throw();

Comentários

Chama CAtlModuleT::InitLibId.

CAtlModuleT::InitLibId

Inicializa o membro de dados que contém o GUID do módulo atual.

static void InitLibId() throw();

Comentários

Chamado pelo construtor CAtlModuleT::CAtlModuleT.

CAtlModuleT::RegisterAppId

Adiciona o EXE ao registro.

HRESULT RegisterAppId() throw();

Valor de retorno

Retornará S_OK se houver êxito ou um erro HRESULT, em caso de falha.

CAtlModuleT::RegisterServer

Adiciona o serviço ao registro.

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

Parâmetros

bRegTypeLib
TRUE se a biblioteca de tipos deve ser registrada. O valor padrão é FALSE.

pCLSID
Aponta para o CLSID do objeto a ser registrado. Se NULL (o valor padrão), todos os objetos no mapa de objetos serão registrados.

Valor de retorno

Retornará S_OK se houver êxito ou um erro HRESULT, em caso de falha.

CAtlModuleT::UnregisterAppId

Remove o EXE do registro.

HRESULT UnregisterAppId() throw();

Valor de retorno

Retornará S_OK se houver êxito ou um erro HRESULT, em caso de falha.

CAtlModuleT::UnregisterServer

Remove o serviço do registro.

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

Parâmetros

bUnRegTypeLib
TRUE se o registro da biblioteca de tipos também precisar ser cancelado.

pCLSID
Aponta para o CLSID do objeto a ser cancelado. Se NULL (o valor padrão), todos os objetos no mapa de objetos terão o registro cancelado.

Valor de retorno

Retornará S_OK se houver êxito ou um erro HRESULT, em caso de falha.

CAtlModuleT::UpdateRegistryAppId

Atualizações as informações do EXE no registro.

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

Parâmetros

bRegister
Reservado.

Valor de retorno

Retornará S_OK se houver êxito ou um erro HRESULT, em caso de falha.

Confira também

Classe CAtlModule
Visão geral da aula
Classes de módulo