Partilhar via

Classe CAtlComModule

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 de servidor COM.

Sintaxe

class CAtlComModule : public _ATL_COM_MODULE

Membros

Construtores Públicos

Nome Description
CAtlComModule::CAtlComModule O construtor.
CAtlComModule::~CAtlComModule O destruidor.

Métodos Públicos

Nome Description
CAtlComModule::RegisterServer Chame este método para atualizar o registo do sistema para cada objeto no mapa do objeto.
CAtlComModule::RegisterTypeLib Chame este método para registar uma biblioteca de tipos.
CAtlComModule::UnregisterServer Chame este método para desregistar cada objeto no mapa de objetos.
CAtlComModule::UnRegisterTypeLib Chame este método para desregistar uma biblioteca de tipos.

Observações

CAtlComModule implementa um módulo servidor COM, permitindo ao cliente aceder aos componentes do módulo.

Esta classe substitui a obsoleta classe CComModule usada em versões anteriores do ATL. Consulte as Aulas de Módulos ATL para mais detalhes.

Hierarquia de herança

_ATL_COM_MODULE

CAtlComModule

Requerimentos

Cabeçalho: atlbase.h

CAtlComModule::CAtlComModule

O construtor.

CAtlComModule() throw();

Observações

Inicializa o módulo.

CAtlComModule::~CAtlComModule

O destruidor.

~CAtlComModule();

Observações

Liberta todas as fábricas de classes.

CAtlComModule::RegisterServer

Chame este método para atualizar o registo do sistema para cada objeto no mapa do objeto.

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

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.

Observações

Chama a função global AtlComModuleRegisterServer.

CAtlComModule::RegisterTypeLib

Chame este método para registar uma biblioteca de tipos.

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

Parâmetros

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

Valor de retorno

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

Observações

Adiciona informação sobre uma biblioteca de tipos ao registo do sistema. Se a instância do módulo contiver múltiplas bibliotecas de tipos, use a primeira versão deste método para especificar qual a biblioteca de tipos que deve ser usada.

CAtlComModule::UnregisterServer

Chame este método para desregistar cada objeto no mapa de objetos.

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

Parâmetros

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

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.

Observações

Chama a função global AtlComModuleUnregisterServer.

CAtlComModule::UnRegisterTypeLib

Chame este método para desregistar uma biblioteca de tipos.

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

Parâmetros

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

Observações

Remove informação sobre uma biblioteca de tipos do registo do sistema. Se a instância do módulo contiver múltiplas bibliotecas de tipos, use a primeira versão deste método para especificar qual a biblioteca de tipos que deve ser usada.

Valor de retorno

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

Consulte também

_ATL_COM_MODULE
Visão geral da classe

  • Last updated on