Classe de CComModule

Artigo
02/25/2013

Até a data de ATL 7,0, CComModule é substituído: consulte Classes de módulo de ATL para obter mais detalhes.

Importante
Essa classe e seus membros não podem ser usados em aplicativos executados em tempo de execução do windows.

class CComModule : public _ATL_MODULE

Membros

Métodos públicos

Nome	Descrição
CComModule::GetClassObject	Cria um objeto de um CLSID especificado.Para apenas dlls.
CComModule::GetModuleInstance	Retorna m_hInst.
CComModule::GetResourceInstance	Retorna m_hInstResource.
CComModule::GetTypeLibInstance	Retorna m_hInstTypeLib.
CComModule::Init	Inicializa membros de dados.
CComModule::RegisterClassHelper	Inserir o registro de classe padrão de um objeto no Registro do sistema.
CComModule::RegisterClassObjects	Registra o objeto da classe.Para EXEs somente.
CComModule::RegisterServer	Atualizar o Registro do sistema para cada objeto no mapa do objeto.
CComModule::RegisterTypeLib	Registra uma biblioteca de tipo.
CComModule::RevokeClassObjects	Revoga o objeto da classe.Para EXEs somente.
CComModule::Term	Libera membros de dados.
CComModule::UnregisterClassHelper	Remove o registro padrão da classe de um objeto de Registro do sistema.
CComModule::UnregisterServer	Desregistre cada objeto no mapa do objeto.
CComModule::UpdateRegistryClass	Desregistre registros ou registro de classe padrão de um objeto.
CComModule::UpdateRegistryFromResourceD	Execute o script contido em um recurso especificado para registrar ou no unregister um objeto.
CComModule::UpdateRegistryFromResourceS	Vincula estaticamente componente de Registro de ATL.Execute o script contido em um recurso especificado para registrar ou no unregister um objeto.

Membros públicos de dados

Nome	Descrição
CComModule::m_csObjMap	Ensures sincronizou acesso a informações do mapa do objeto.
CComModule::m_csTypeInfoHolder	Ensures sincronizou acesso a informações de biblioteca de tipo.
CComModule::m_csWindowCreate	Ensures sincronizou acesso a informações de classe de janela e dados estáticos usados durante a criação da janela.
CComModule::m_hInst	Contém o identificador para a instância do módulo.
CComModule::m_hInstResource	Por padrão, contém o identificador para a instância do módulo.
CComModule::m_hInstTypeLib	Por padrão, contém o identificador para a instância do módulo.
CComModule::m_pObjMap	Os pontos no mapa do objeto mantido pelo módulo instância.

Comentários

Observação
Essa classe é substituída, e os assistentes de geração de código de ATL agora usam as classes derivadas de CAtlAutoThreadModule e de CAtlModule .Consulte Classes de módulo de ATL para mais informações.Informações que segue é para uso com os aplicativos criados com as versões mais antigas de ATL.CComModule ainda é parte de ATL para trás para o recurso.

CComModule implementa um módulo de servidor COM, permitindo que um cliente acessar os componentes do módulo.CComModule suporta os módulos de processo em (DLL) e o EXE (local).

Uma instância de CComModule usa um mapa de objeto para manter um conjunto de definições de objeto da classe.Esse mapeamento de objeto é implementado como uma matriz de estruturas de _ATL_OBJMAP_ENTRY , e contém informações para:

Inserindo e removendo descrições de objeto no Registro do sistema.
Criando uma instância objetos através de uma fábrica da classe.
Estabelecendo comunicação entre um cliente e o objeto raiz no componente.
Executando o gerenciamento de vida útil de objeto da classe.

Quando você executa o ATL COM AppWizard, o assistente gera automaticamente _Module, uma instância global de CComModule ou uma classe derivada de ela.Para obter mais informações sobre o assistente de projeto de ATL, consulte o artigo Criando um projeto ATL.

Além de CComModule, ATL fornece CComAutoThreadModule, que implementa um módulo de apartamento- modelo para EXEs e Serviços do Windows.Derive o módulo de CComAutoThreadModule quando você deseja criar objetos em vários construção.