Partilhar via

Classe CAtlModuleT

Observação

A Active Template Library (ATL) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Esta classe implementa um módulo ATL.

Sintaxe

template <class T>
class ATL_NO_VTABLE CAtlModuleT : public CAtlModule

Parâmetros

T
A sua classe derivou de CAtlModuleT.

Membros

Construtores Públicos

Nome Description
CAtlModuleT::CAtlModuleT O construtor.

Métodos Públicos

Nome Description
CAtlModuleT::InitLibId Inicializa o elemento de dados que contém o GUID do módulo atual.
CAtlModuleT::RegisterAppId Adiciona o EXE ao registo.
CAtlModuleT::RegisterServer Adiciona o serviço ao registo.
CAtlModuleT::UnregisterAppId Remove o EXE do registo.
CAtlModuleT::UnregisterServer Remove o serviço do registo.
CAtlModuleT::UpdateRegistryAppId Atualiza a informação EXE no registo.

Observações

CAtlModuleT, derivado de CAtlModule, implementa um módulo ATL executável (EXE) ou Service (EXE). Um módulo executável é um servidor local, fora de processo, enquanto um módulo de Serviço é uma aplicação Windows que corre em segundo plano quando o Windows inicia.

CAtlModuleT fornece suporte para inicializar, registar e desregistar o módulo.

Hierarquia de herança

_ATL_MODULE

CAtlModule

CAtlModuleT

Requerimentos

Cabeçalho: atlbase.h

CAtlModuleT::CAtlModuleT

O construtor.

CAtlModuleT() throw();

Observações

Chama CAtlModuleT::InitLibId.

CAtlModuleT::InitLibId

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

static void InitLibId() throw();

Observações

Chamado pelo construtor CAtlModuleT::CAtlModuleT.

CAtlModuleT::RegisterAppId

Adiciona o EXE ao registo.

HRESULT RegisterAppId() throw();

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CAtlModuleT::RegisterServer

Adiciona o serviço ao registo.

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

Parâmetros

bRegTypeLib
TRUE se a biblioteca de tipos for registada. O valor padrão é FALSE.

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

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CAtlModuleT::UnregisterAppId

Remove o EXE do registo.

HRESULT UnregisterAppId() throw();

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CAtlModuleT::UnregisterServer

Remove o serviço do registo.

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

Parâmetros

bUnRegTypeLib
TRUE se a biblioteca de tipos também for para não estar registada.

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

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CAtlModuleT::UpdateRegistryAppId

Atualiza a informação EXE no registo.

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

Parâmetros

bRegister
Reservado.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Consulte também

Classe CAtlModule
Visão geral da classe
Classes de Módulo

  • Last updated on