Compartilhar via

Classe CAtlComModule

  • Artigo

Essa classe implementa um módulo de servidor COM.

Sintaxe

class CAtlComModule : public _ATL_COM_MODULE

Membros

Construtores públicos

Nome Descrição
CAtlComModule::CAtlComModule O construtor .
CAtlComModule::~CAtlComModule O destruidor.

Métodos públicos

Nome Descrição
CAtlComModule::RegisterServer Chame esse método para atualizar o registro do sistema para cada objeto no mapa de objetos.
CAtlComModule::RegisterTypeLib Chame esse método para registrar uma biblioteca de tipos.
CAtlComModule::UnregisterServer Chame esse método para cancelar o registro de cada objeto no mapa de objetos.
CAtlComModule::UnRegisterTypeLib Chame esse método para cancelar o registro de uma biblioteca de tipos.

Comentários

CAtlComModule implementa um módulo de servidor COM, permitindo que um cliente acesse os componentes do módulo.

Essa classe substitui a classe CComModule obsoleta usada em versões anteriores da ATL. Confira Classes de módulo da ATL para obter mais detalhes.

Hierarquia de herança

_ATL_COM_MODULE

CAtlComModule

Requisitos

Cabeçalho: atlbase.h

CAtlComModule::CAtlComModule

O construtor .

CAtlComModule() throw();

Comentários

Inicializa o módulo.

CAtlComModule::~CAtlComModule

O destruidor.

~CAtlComModule();

Comentários

Libera todas as fábricas de classes.

CAtlComModule::RegisterServer

Chame esse método para atualizar o registro do sistema para cada objeto no mapa de objetos.

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

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.

Comentários

Chama a função global AtlComModuleRegisterServer.

CAtlComModule::RegisterTypeLib

Chame esse método para registrar uma biblioteca de tipos.

HRESULT RegisterTypeLib(LPCTSTR lpszIndex);
HRESULT RegisterTypeLib();

Parâmetros

lpszIndex
Cadeia de caracteres no formato "\\N", onde N é o índice inteiro do recurso TYPELIB.

Valor de retorno

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

Comentários

Adiciona informações sobre uma biblioteca de tipos ao registro do sistema. Se a instância do módulo contiver várias bibliotecas de tipos, use a primeira versão desse método para especificar qual biblioteca de tipos deve ser usada.

CAtlComModule::UnregisterServer

Chame esse método para cancelar o registro de cada objeto no mapa de objetos.

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

Parâmetros

bRegTypeLib
TRUE se o registro da biblioteca de tipos deve ser cancelado. O valor padrão é FALSE.

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.

Comentários

Chama a função global AtlComModuleUnregisterServer.

CAtlComModule::UnRegisterTypeLib

Chame esse método para cancelar o registro de uma biblioteca de tipos.

HRESULT UnRegisterTypeLib(LPCTSTR lpszIndex);
HRESULT UnRegisterTypeLib();

Parâmetros

lpszIndex
Cadeia de caracteres no formato "\\N", onde N é o índice inteiro do recurso TYPELIB.

Comentários

Remove informações sobre uma biblioteca de tipos do registro do sistema. Se a instância do módulo contiver várias bibliotecas de tipos, use a primeira versão desse método para especificar qual biblioteca de tipos deve ser usada.

Valor de retorno

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

Confira também

_ATL_COM_MODULE
Visão geral da aula