Classe IAtlMemMgr

Artigo
08/03/2024

Essa classe representa a interface para um gerenciador de memória de .

Sintaxe

__interface __declspec(uuid("654F7EF5-CFDF-4df9-A450-6C6A13C622C0")) IAtlMemMgr

Membros

Métodos

Nome	Descrição
Allocate	Chame esse método para alocar um bloco de memória.
Gratuito	Chame esse método para liberar um bloco de memória.
GetSize	Chame esse método para recuperar o tamanho de um bloco de memória alocado.
Reallocate	Chame esse método para realocar um bloco de memória.

Comentários

Essa interface é implementada por CComHeap, CCRTHeap, CLocalHeap, CGlobalHeap ou CWin32Heap.

Observação

As funções de heap globais e locais são mais lentas do que outras funções de gerenciamento de memória e não fornecem tantos recursos. Portanto, novos aplicativos devem usar as funções de heap. Eles estão disponíveis na classe CWin32Heap.

Exemplo

// Demonstrate IAtlMemMgr using the five possible
// memory function implementation classes. 

HRESULT MemoryManagerDemonstration(IAtlMemMgr& MemoryManager) throw()
{
   // The IAtlMemMgr interface guarantees not to throw exceptions
   // so we can make the same guarantee for this function
   // without adding exception handling code.

   // A variable which will point to some allocated memory.
   void* pMemory = NULL;

   const size_t BytesInChunk = 1024;

   // Allocate a chunk of memory
   pMemory = MemoryManager.Allocate(BytesInChunk);

   // Confirm the validity of the allocated memory
   if (pMemory == NULL)
      return E_OUTOFMEMORY;

   // Confirm the size of the allocated memory
   ATLASSERT(MemoryManager.GetSize(pMemory) == BytesInChunk);

   // Increase the size of the allocated memory
   pMemory = MemoryManager.Reallocate(pMemory, BytesInChunk * 2);

   // Confirm the validity of the allocated memory
   if (pMemory == NULL)
      return E_OUTOFMEMORY;

   // Confirm the size of the reallocated  memory
   ATLASSERT(MemoryManager.GetSize(pMemory) == BytesInChunk * 2);

   // Free the allocated memory
   MemoryManager.Free(pMemory);

   return S_OK;
}

int DoMemoryManagerDemonstration()
{
   CComHeap heapCom;
   CCRTHeap heapCrt;
   CLocalHeap heapLocal;
   CGlobalHeap heapGlobal;
   // It is necessary to provide extra information 
   // to the constructor when using CWin32Heap
   CWin32Heap heapWin32(NULL, 4096); 

   ATLASSERT(S_OK==MemoryManagerDemonstration(heapCom));
   ATLASSERT(S_OK==MemoryManagerDemonstration(heapCrt));
   ATLASSERT(S_OK==MemoryManagerDemonstration(heapLocal));
   ATLASSERT(S_OK==MemoryManagerDemonstration(heapGlobal));
   ATLASSERT(S_OK==MemoryManagerDemonstration(heapWin32));

   return 0;
}

Requisitos

Cabeçalho: atlmem.h

IAtlMemMgr::Allocate

Chame esse método para alocar um bloco de memória.

void* Allocate(size_t nBytes) throw();

Parâmetros

nBytes
O número solicitado de bytes no novo bloco de memória.

Valor de retorno

Retorna um ponteiro para o início do bloco de memória recém-alocado.

Comentários

Chame IAtlMemMgr::Free ou IAtlMemMgr::Reallocate para liberar a memória alocada por esse método.

Exemplo

Para obter um exemplo, confira a Visão geral do IAtlMemMgr.

IAtlMemMgr::Free

Chame esse método para liberar um bloco de memória.

void Free(void* p) throw();

Parâmetros

p
Ponteiro para a memória alocada anteriormente por esse gerenciador de memória.

Comentários

Use esse método para liberar a memória obtida por IAtlMemMgr::Allocate ou IAtlMemMgr::Reallocate.

Exemplo

Para obter um exemplo, confira a Visão geral do IAtlMemMgr.

IAtlMemMgr::GetSize

Chame esse método para recuperar o tamanho de um bloco de memória alocado.

size_t GetSize(void* p) throw();

Parâmetros

p
Ponteiro para a memória alocada anteriormente por esse gerenciador de memória.

Valor de retorno

Retorna o tamanho do bloco de memória em bytes.

Exemplo

Para obter um exemplo, confira a Visão geral do IAtlMemMgr.

IAtlMemMgr::Reallocate

Chame esse método para realocar a memória alocada por esse gerenciador de memória.

void* Reallocate(void* p, size_t nBytes) throw();

Parâmetros

p
Ponteiro para a memória alocada anteriormente por esse gerenciador de memória.

nBytes
O número solicitado de bytes no novo bloco de memória.

Valor de retorno

Retorna um ponteiro para o início do bloco de memória recém-alocado.

Comentários

Chame IAtlMemMgr::Free ou IAtlMemMgr::Reallocate para liberar a memória alocada por esse método.

Conceitualmente, esse método libera a memória existente e aloca um novo bloco de memória. Na realidade, a memória existente pode ser estendida ou reutilizada.

Exemplo

Para obter um exemplo, confira a Visão geral do IAtlMemMgr.

IAxWinAmbientDispatch::get_AllowContextMenu

A propriedade AllowContextMenu especifica se o controle hospedado tem permissão para exibir o próprio menu de contexto.

STDMETHOD(get_AllowContextMenu)(VARIANT_BOOL* pbAllowContextMenu);

Parâmetros

pbAllowContextMenu
[out] O endereço de uma variável para receber o valor atual dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa VARIANT_TRUE como o valor padrão dessa propriedade.

IAxWinAmbientDispatch::get_AllowShowUI

A propriedade AllowShowUI especifica se o controle hospedado tem permissão para exibir a própria interface do usuário.

STDMETHOD(get_AllowShowUI)(VARIANT_BOOL* pbAllowShowUI);

Parâmetros

pbAllowShowUI
[out] O endereço de uma variável para receber o valor atual dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa VARIANT_FALSE como o valor padrão dessa propriedade.

IAxWinAmbientDispatch::get_AllowWindowlessActivation

A propriedade AllowWindowlessActivation especifica se o contêiner permitirá a ativação sem janelas.

STDMETHOD(get_AllowWindowlessActivation)(VARIANT_BOOL* pbAllowWindowless);

Parâmetros

pbAllowWindowless
[out] O endereço de uma variável para receber o valor atual dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa VARIANT_TRUE como o valor padrão dessa propriedade.

IAxWinAmbientDispatch::get_BackColor

A propriedade BackColor especifica a cor da tela de fundo do ambiente do contêiner.

STDMETHOD(get_BackColor)(OLE_COLOR* pclrBackground);

Parâmetros

pclrBackground
[out] O endereço de uma variável para receber o valor atual dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa COLOR_BTNFACE ou COLOR_WINDOW como o valor padrão dessa propriedade (dependendo de se o pai da janela do host é uma caixa de diálogo ou não).

IAxWinAmbientDispatch::get_DisplayAsDefault

DisplayAsDefault é uma propriedade de ambiente que permite que um controle descubra se é o controle padrão.

STDMETHOD(get_DisplayAsDefault)(VARIANT_BOOL* pbDisplayAsDefault);

Parâmetros

pbDisplayAsDefault
[out] O endereço de uma variável para receber o valor atual dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa VARIANT_FALSE como o valor padrão dessa propriedade.

IAxWinAmbientDispatch::get_DocHostDoubleClickFlags

A propriedade DocHostDoubleClickFlags especifica a operação que deve ocorrer em resposta a um clique duplo.

STDMETHOD(get_DocHostDoubleClickFlags)(DWORD* pdwDocHostDoubleClickFlags);

Parâmetros

pdwDocHostDoubleClickFlags
[out] O endereço de uma variável para receber o valor atual dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa DOCHOSTUIDBLCLK_DEFAULT como o valor padrão dessa propriedade.

IAxWinAmbientDispatch::get_DocHostFlags

A propriedade DocHostFlags especifica os recursos de interface do usuário do objeto host.

STDMETHOD(get_DocHostFlags)(DWORD* pdwDocHostFlags);

Parâmetros

pdwDocHostFlags
[out] O endereço de uma variável para receber o valor atual dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa DOCHOSTUIFLAG_NO3DBORDER como o valor padrão dessa propriedade.

IAxWinAmbientDispatch::get_Font

A propriedade Font especifica a fonte do ambiente do contêiner.

STDMETHOD(get_Font)(IFontDisp** pFont);

Parâmetros

pFont
[out] O endereço de um ponteiro de interface IFontDisp usado para receber o valor atual dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa a fonte GUI padrão ou a fonte do sistema como o valor padrão dessa propriedade.

IAxWinAmbientDispatch::get_ForeColor

A propriedade ForeColor especifica a cor de primeiro plano do ambiente do contêiner.

STDMETHOD(get_ForeColor)(OLE_COLOR* pclrForeground);

Parâmetros

pclrForeground
[out] O endereço de uma variável para receber o valor atual dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa a cor do texto da janela do sistema como o valor padrão dessa propriedade.

IAxWinAmbientDispatch::get_LocaleID

A propriedade LocaleID especifica a ID de localidade do ambiente do contêiner.

STDMETHOD(get_LocaleID)(LCID* plcidLocaleID);

Parâmetros

plcidLocaleID
[out] O endereço de uma variável para receber o valor atual dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa a localidade padrão do usuário como o valor padrão dessa propriedade.

Com esse método, você pode descobrir a LocalID de Ambiente, ou seja, a LocaleID do programa em que seu controle está sendo usado. Depois de conhecer a LocaleID, você poderá chamar o código para carregar legendas específicas à localidade, texto da mensagem de erro, e assim por diante, de um arquivo de recurso ou DLL satélite.

IAxWinAmbientDispatch::get_MessageReflect

A propriedade ambiente MessageReflect especifica se o contêiner refletirá as mensagens para o controle hospedado.

STDMETHOD(get_MessageReflect)(VARIANT_BOOL* pbMessageReflect);

Parâmetros

pbMessageReflect
[out] O endereço de uma variável para receber o valor atual dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa VARIANT_TRUE como o valor padrão dessa propriedade.

IAxWinAmbientDispatch::get_OptionKeyPath

A propriedade OptionKeyPath especifica o caminho da chave do Registro para as configurações do usuário.

STDMETHOD(get_OptionKeyPath)(BSTR* pbstrOptionKeyPath);

Parâmetros

pbstrOptionKeyPath
[out] O endereço de uma variável para receber o valor atual dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

IAxWinAmbientDispatch::get_ShowGrabHandles

A propriedade de ambiente ShowGrabHandles permite que o controle descubra se ele deve desenhar-se com identificadores de captura.

STDMETHOD(get_ShowGrabHandles)(VARIANT_BOOL* pbShowGrabHandles);

Parâmetros

pbShowGrabHandles
[out] O endereço de uma variável para receber o valor atual dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL sempre retorna VARIANT_FALSE como o valor dessa propriedade.

IAxWinAmbientDispatch::get_ShowHatching

A propriedade de ambiente ShowHatching permite que o controle descubra se deve se desenhar hachurado.

STDMETHOD(get_ShowHatching)(VARIANT_BOOL* pbShowHatching);

Parâmetros

pbShowHatching
[out] O endereço de uma variável para receber o valor atual dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL sempre retorna VARIANT_FALSE como o valor dessa propriedade.

IAxWinAmbientDispatch::get_UserMode

A propriedade UserMode especifica o modo de usuário do ambiente do contêiner.

STDMETHOD(get_UserMode)(VARIANT_BOOL* pbUserMode);

Parâmetros

pbUserMode
[out] O endereço de uma variável para receber o valor atual dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa VARIANT_TRUE como o valor padrão dessa propriedade.

IAxWinAmbientDispatch::put_AllowContextMenu

A propriedade AllowContextMenu especifica se o controle hospedado tem permissão para exibir o próprio menu de contexto.

STDMETHOD(put_AllowContextMenu)(VARIANT_BOOL bAllowContextMenu);

Parâmetros

bAllowContextMenu
[in] O novo valor dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa VARIANT_TRUE como o valor padrão dessa propriedade.

IAxWinAmbientDispatch::put_AllowShowUI

A propriedade AllowShowUI especifica se o controle hospedado tem permissão para exibir a própria interface do usuário.

STDMETHOD(put_AllowShowUI)(VARIANT_BOOL bAllowShowUI);

Parâmetros

bAllowShowUI
[in] O novo valor dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa VARIANT_FALSE como o valor padrão dessa propriedade.

IAxWinAmbientDispatch::put_AllowWindowlessActivation

A propriedade AllowWindowlessActivation especifica se o contêiner permitirá a ativação sem janelas.

STDMETHOD(put_AllowWindowlessActivation)(VARIANT_BOOL bAllowWindowless);

Parâmetros

bAllowWindowless
[in] O novo valor dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa VARIANT_TRUE como o valor padrão dessa propriedade.

IAxWinAmbientDispatch::put_BackColor

A propriedade BackColor especifica a cor da tela de fundo do ambiente do contêiner.

STDMETHOD(put_BackColor)(OLE_COLOR clrBackground);

Parâmetros

clrBackground
[in] O novo valor dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa COLOR_BTNFACE ou COLOR_WINDOW como o valor padrão dessa propriedade (dependendo de se o pai da janela do host é uma caixa de diálogo ou não).

IAxWinAmbientDispatch::put_DisplayAsDefault

DisplayAsDefault é uma propriedade de ambiente que permite que um controle descubra se é o controle padrão.

STDMETHOD(put_DisplayAsDefault)(VARIANT_BOOL bDisplayAsDefault);

Parâmetros

bDisplayAsDefault
[in] O novo valor dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa VARIANT_FALSE como o valor padrão dessa propriedade.

IAxWinAmbientDispatch::put_DocHostDoubleClickFlags

A propriedade DocHostDoubleClickFlags especifica a operação que deve ocorrer em resposta a um clique duplo.

STDMETHOD(put_DocHostDoubleClickFlags)(DWORD dwDocHostDoubleClickFlags);

Parâmetros

dwDocHostDoubleClickFlags
[in] O novo valor dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa DOCHOSTUIDBLCLK_DEFAULT como o valor padrão dessa propriedade.

IAxWinAmbientDispatch::put_DocHostFlags

A propriedade DocHostFlags especifica os recursos de interface do usuário do objeto host.

STDMETHOD(put_DocHostFlags)(DWORD dwDocHostFlags);

Parâmetros

dwDocHostFlags
[in] O novo valor dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa DOCHOSTUIFLAG_NO3DBORDER como o valor padrão dessa propriedade.

IAxWinAmbientDispatch::put_Font

A propriedade Font especifica a fonte do ambiente do contêiner.

STDMETHOD(put_Font)(IFontDisp* pFont);

Parâmetros

pFont
[in] O novo valor dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa a fonte GUI padrão ou a fonte do sistema como o valor padrão dessa propriedade.

IAxWinAmbientDispatch::put_ForeColor

A propriedade ForeColor especifica a cor de primeiro plano do ambiente do contêiner.

STDMETHOD(put_ForeColor)(OLE_COLOR clrForeground);

Parâmetros

clrForeground
[in] O novo valor dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa a cor do texto da janela do sistema como o valor padrão dessa propriedade.

IAxWinAmbientDispatch::put_LocaleID

A propriedade LocaleID especifica a ID de localidade do ambiente do contêiner.

STDMETHOD(put_LocaleID)(LCID lcidLocaleID);

Parâmetros

lcidLocaleID
[in] O novo valor dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa a localidade padrão do usuário como o valor padrão dessa propriedade.

IAxWinAmbientDispatch::put_MessageReflect

A propriedade ambiente MessageReflect especifica se o contêiner refletirá as mensagens para o controle hospedado.

STDMETHOD(put_MessageReflect)(VARIANT_BOOL bMessageReflect);

Parâmetros

bMessageReflect
[in] O novo valor dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa VARIANT_TRUE como o valor padrão dessa propriedade.

IAxWinAmbientDispatch::put_OptionKeyPath

A propriedade OptionKeyPath especifica o caminho da chave do Registro para as configurações do usuário.

STDMETHOD(put_OptionKeyPath)(BSTR bstrOptionKeyPath);

Parâmetros

bstrOptionKeyPath
[in] O novo valor dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

IAxWinAmbientDispatch::put_UserMode

A propriedade UserMode especifica o modo de usuário do ambiente do contêiner.

STDMETHOD(put_UserMode)(VARIANT_BOOL bUserMode);

Parâmetros

bUserMode
[in] O novo valor dessa propriedade.

Valor de retorno

Um valor HRESULT padrão.

Comentários

A implementação do objeto host ATL usa VARIANT_TRUE como o valor padrão dessa propriedade.

IAxWinAmbientDispatchEx::SetAmbientDispatch

Esse método é chamado para complementar a interface de propriedade ambiente padrão com uma interface definida pelo usuário.

virtual HRESULT STDMETHODCALLTYPE SetAmbientDispatch(IDispatch* pDispatch) = 0;

Parâmetros

pDispatch
Ponteiro para a nova interface .

Valor de retorno

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

Comentários

Quando SetAmbientDispatch for chamado com um ponteiro para uma nova interface, essa nova interface será usada para invocar quaisquer propriedades ou métodos solicitados pelo controle hospedado, se essas propriedades ainda não forem fornecidas por IAxWinAmbientDispatch.

IAxWinHostWindow::AttachControl

Anexa um controle existente (e inicializado anteriormente) ao objeto host usando a janela identificada pelo hWnd.

STDMETHOD(AttachControl)(IUnknown* pUnkControl, HWND hWnd);

Parâmetros

pUnkControl
[in] Um ponteiro para a interface IUnknown do controle a ser anexado ao objeto host.

hWnd
[in] Um identificador para a janela a ser usada para hospedagem.

Valor de retorno

Um valor HRESULT padrão.

IAxWinHostWindow::CreateControl

Cria um controle, inicializa-o e hospeda-o na janela identificada pelo hWnd.

STDMETHOD(CreateControl)(
    LPCOLESTR lpTricsData,
    HWND hWnd,
    IStream* pStream);

Parâmetros

lpTricsData
[in] Uma cadeia de caracteres que identifica o controle a ser criado. Pode ser um CLSID (deve incluir as chaves), ProgID, URL ou HTML bruto (prefixado por MSHTML:).

hWnd
[in] Um identificador para a janela a ser usada para hospedagem.

pStream
[in] Um ponteiro de interface para um fluxo que contém dados de inicialização para o controle. Pode ser NULL.

Valor de retorno

Um valor HRESULT padrão.

Comentários

Essa janela será subclasse pelo objeto host expondo essa interface para que as mensagens possam ser refletidas no controle e outros recursos de contêiner funcionarão.

Chamar esse método é equivalente a chamar IAxWinHostWindow::CreateControlEx.

Para criar um controle ActiveX licenciado, confira IAxWinHostWindowLic::CreateControlLic.

IAxWinHostWindow::CreateControlEx

Cria um controle ActiveX, inicializa-o e hospeda-o na janela especificada, semelhante a IAxWinHostWindow::CreateControl.

STDMETHOD(CreateControlEx)(
    LPCOLESTR lpszTricsData,
    HWND hWnd,
    IStream* pStream,
    IUnknown** ppUnk,
    REFIID riidAdvise,
    IUnknown* punkAdvise);

Parâmetros

lpTricsData
[in] Uma cadeia de caracteres que identifica o controle a ser criado. Pode ser um CLSID (deve incluir as chaves), ProgID, URL ou HTML bruto (prefixado com MSHTML:).

hWnd
[in] Um identificador para a janela a ser usada para hospedagem.

pStream
[in] Um ponteiro de interface para um fluxo que contém dados de inicialização para o controle. Pode ser NULL.

ppUnk
[out] O endereço de um ponteiro que receberá a interface IUnknown do controle criado. Pode ser NULL.

riidAdvise
[in] O identificador de interface de uma interface de saída no objeto contido. Pode ser IID_NULL.

punkAdvise
[in] Um ponteiro para a interface IUnknown do objeto coletor a ser conectado ao ponto de conexão no objeto contido especificado por iidSink.

Valor de retorno

Um valor HRESULT padrão.

Comentários

Ao contrário do método CreateControl, CreateControlEx também permite que você receba um ponteiro de interface para o controle recém-criado e configure um coletor de eventos para receber eventos disparados pelo controle.

Para criar um controle ActiveX licenciado, confira IAxWinHostWindowLic::CreateControlLicEx.

IAxWinHostWindow::QueryControl

Retorna o ponteiro de interface especificado fornecido pelo controle hospedado.

STDMETHOD(QueryControl)(REFIID riid, void** ppvObject);

Parâmetros

riid
[in] A ID de uma interface no controle que está sendo solicitado.

ppvObject
[out] O endereço de um ponteiro que receberá a interface especificada do controle criado.

Valor de retorno

Um valor HRESULT padrão.

IAxWinHostWindow::SetExternalDispatch

Define a dispinterface externa, que está disponível para controles contidos por meio do método IDocHostUIHandlerDispatch::GetExternal.

STDMETHOD(SetExternalDispatch)(IDispatch* pDisp);

Parâmetros

pDisp
[in] Um ponteiro para uma interface IDispatch.

Valor de retorno

Um valor HRESULT padrão.

IAxWinHostWindow::SetExternalUIHandler

Chame essa função para definir a interface IDocHostUIHandlerDispatch externa para o objeto CAxWindow.

STDMETHOD(SetExternalUIHandler)(IDocHostUIHandlerDispatch* pDisp);

Parâmetros

pDisp
[in] Um ponteiro para uma interface IDocHostUIHandlerDispatch.

Valor de retorno

Um valor HRESULT padrão.

Comentários

Essa função é usada por controles (como o controle do navegador da Web) que consultam o site do host para a interface IDocHostUIHandlerDispatch.

IAxWinHostWindowLic::CreateControlLic

Cria um controle licenciado, inicializa-o e hospeda-o na janela identificada pelo hWnd.

STDMETHOD(CreateControlLic)(
    LPCOLESTR lpTricsData,
    HWND hWnd,
    IStream* pStream,
    BSTR bstrLic);

Parâmetros

bstrLic
[entrada] O BSTR que contém a chave de licença para o controle.

Comentários

Confira IAxWinHostWindow::CreateControl para obter uma descrição dos parâmetros restantes e do valor retornado.

Chamar esse método é equivalente a chamar IAxWinHostWindowLic::CreateControlLicEx

Exemplo

Confira Hospedagem de Controles ActiveX usando o AXHost da ATL para obter um exemplo que usa IAxWinHostWindowLic::CreateControlLic.

IAxWinHostWindowLic::CreateControlLicEx

Cria um controle ActiveX licenciado, inicializa-o e hospeda-o na janela especificada, semelhante a IAxWinHostWindow::CreateControl.

STDMETHOD(CreateControlLicEx)(
    LPCOLESTR lpszTricsData,
    HWND hWnd,
    IStream* pStream,
    IUnknown** ppUnk,
    REFIID riidAdvise,
    IUnknown* punkAdvise,
    BSTR bstrLic);

Parâmetros

bstrLic
[entrada] O BSTR que contém a chave de licença para o controle.

Comentários

Confira IAxWinHostWindow::CreateControlEx para obter uma descrição dos parâmetros restantes e do valor retornado.

Exemplo

Confira Hospedagem de Controles ActiveX usando o AXHost da ATL para obter um exemplo que usa IAxWinHostWindowLic::CreateControlLicEx.

Confira também

Visão geral da aula

Compartilhar via

Classe IAtlMemMgr

Sintaxe

Membros

Métodos

Comentários

Exemplo

Requisitos

IAtlMemMgr::Allocate

Parâmetros

Valor de retorno

Comentários

Exemplo

IAtlMemMgr::Free

Parâmetros

Comentários

Exemplo

IAtlMemMgr::GetSize

Parâmetros

Valor de retorno

Exemplo

IAtlMemMgr::Reallocate

Parâmetros

Valor de retorno

Comentários

Exemplo

IAxWinAmbientDispatch::get_AllowContextMenu

Parâmetros

Valor de retorno

Comentários

IAxWinAmbientDispatch::get_AllowShowUI

Parâmetros

Valor de retorno

Comentários

IAxWinAmbientDispatch::get_AllowWindowlessActivation

Parâmetros

Valor de retorno

Comentários

IAxWinAmbientDispatch::get_BackColor

Parâmetros

Valor de retorno

Comentários

IAxWinAmbientDispatch::get_DisplayAsDefault

Parâmetros

Valor de retorno

Comentários

IAxWinAmbientDispatch::get_DocHostDoubleClickFlags

Parâmetros

Valor de retorno

Comentários

IAxWinAmbientDispatch::get_DocHostFlags

Parâmetros

Valor de retorno

Comentários

IAxWinAmbientDispatch::get_Font

Parâmetros

Valor de retorno

Comentários

IAxWinAmbientDispatch::get_ForeColor

Parâmetros

Valor de retorno

Comentários

IAxWinAmbientDispatch::get_LocaleID

Parâmetros

Valor de retorno

Comentários

IAxWinAmbientDispatch::get_MessageReflect

Parâmetros

Valor de retorno

Comentários

IAxWinAmbientDispatch::get_OptionKeyPath

Parâmetros

Valor de retorno

IAxWinAmbientDispatch::get_ShowGrabHandles

Parâmetros

Valor de retorno

Comentários

IAxWinAmbientDispatch::get_ShowHatching

Parâmetros

Valor de retorno