Classe IAtlMemMgr
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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
clrAntecedentes
[in] O novo valor dessa propriedade.
Valor de Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de