Partilhar via


Classe CAtlBaseModule

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 disciplina é instaurada em todos os projetos da ATL.

Sintaxe

class CAtlBaseModule : public _ATL_BASE_MODULE

Membros

Construtores Públicos

Nome Description
CAtlBaseModule::CAtlBaseModule O construtor.

Métodos Públicos

Nome Description
CAtlBaseModule::AddResourceInstance Adiciona uma instância de recurso à lista de handles armazenados.
CAtlBaseModule::GetHInstanceAt Devolve um handle a uma instância de recurso especificada.
CAtlBaseModule::GetModuleInstance Devolve a instância do módulo a partir de um CAtlBaseModule objeto.
CAtlBaseModule::GetResourceInstance Devolve a instância de recurso de um CAtlBaseModule objeto.
CAtlBaseModule::RemoveResourceInstance Remove uma instância de recurso da lista de handles armazenados.
CAtlBaseModule::SetResourceInstance Define a instância de recurso de um CAtlBaseModule objeto.

Membros de Dados Públicos

Nome Description
CAtlBaseModule::m_bInitFailed Uma variável que indica se a inicialização do módulo falhou.

Observações

Uma instância de CAtlBaseModule _AtlBaseModule nomeada está presente em cada projeto ATL, contendo um handle para a instância do módulo, um handle para o módulo que contém recursos (que, por defeito, são um e o mesmo), e um array de handles para módulos que fornecem recursos primários. CAtlBaseModule pode ser acedido em segurança a partir de múltiplos threads.

Esta classe substitui a obsoleta classe CComModule usada em versões anteriores do ATL.

Hierarquia de herança

_ATL_BASE_MODULE

CAtlBaseModule

Requerimentos

Cabeçalho: atlcore.h

CAtlBaseModule::AddResourceInstance

Adiciona uma instância de recurso à lista de handles armazenados.

bool AddResourceInstance(HINSTANCE hInst) throw();

Parâmetros

hInst
A instância de recurso a adicionar.

Valor de retorno

Retorna true se o recurso foi adicionado com sucesso, false caso contrário.

CAtlBaseModule::CAtlBaseModule

O construtor.

CAtlBaseModule() throw();

Observações

Cria o CAtlBaseModule.

CAtlBaseModule::GetHInstanceAt

Devolve um handle a uma instância de recurso especificada.

HINSTANCE GetHInstanceAt(int i) throw();

Parâmetros

eu
O número da instância de recurso.

Valor de retorno

Devolve o handle à instância de recurso, ou NULL se não existir uma instância de recurso correspondente.

CAtlBaseModule::GetModuleInstance

Devolve a instância do módulo a partir de um CAtlBaseModule objeto.

HINSTANCE GetModuleInstance() throw();

Valor de retorno

Devolve a instância do módulo.

CAtlBaseModule::GetResourceInstance

Devolve a instância de recurso.

HINSTANCE GetResourceInstance() throw();

Valor de retorno

Devolve a instância de recurso.

CAtlBaseModule::m_bInitFailed

Uma variável que indica se a inicialização do módulo falhou.

static bool m_bInitFailed;

Observações

Verdadeiro se o módulo foi inicializado, falso se não se inicializou.

CAtlBaseModule::RemoveResourceInstance

Remove uma instância de recurso da lista de handles armazenados.

bool RemoveResourceInstance(HINSTANCE hInst) throw();

Parâmetros

hInst
A instância de recurso a remover.

Valor de retorno

Retorna true se o recurso foi removido com sucesso, false caso contrário.

CAtlBaseModule::SetResourceInstance

Define a instância de recurso de um CAtlBaseModule objeto.

HINSTANCE SetResourceInstance(HINSTANCE hInst) throw();

Parâmetros

hInst
A nova instância de recursos.

Valor de retorno

Devolve a instância de recurso atualizada.

Consulte também

Visão geral da classe
Classes de Módulo