Compartir a través de


Clase IAtlMemMgr

Esta clase representa la interfaz de un administrador de memoria .

Sintaxis

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

Miembros

Métodos

Nombre Descripción
Allocate Llame a este método para asignar un bloque de memoria.
Gratis Llame a este método para liberar un bloque de memoria.
GetSize Llame a este método para recuperar el tamaño de un bloque de memoria asignado.
Reallocate Llame a este método para reasignar un bloque de memoria.

Comentarios

Esta interfaz se implementa mediante CComHeap, CCRTHeap, CLocalHeap, CGlobalHeap o CWin32Heap.

Nota:

Las funciones de montón local y global son más lentas que otras funciones de administración de memoria y no proporcionan tantas características. Por lo tanto, las nuevas aplicaciones deben usar las funciones del montón. Están disponibles en la clase CWin32Heap.

Ejemplo

// 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

Encabezado: atlmem.h

IAtlMemMgr::Allocate

Llame a este método para asignar un bloque de memoria.

void* Allocate(size_t nBytes) throw();

Parámetros

nBytes
Número de bytes solicitado en el nuevo bloque de memoria.

Valor devuelto

Devuelve un puntero al principio del bloque de memoria recién asignado.

Comentarios

Llame a IAtlMemMgr::Free oIAtlMemMgr::Reallocate para liberar la memoria asignada por este método.

Ejemplo

Para obtener un ejemplo, consulte información general sobre IAtlMemMgr.

IAtlMemMgr::Free

Llame a este método para liberar un bloque de memoria.

void Free(void* p) throw();

Parámetros

p
Puntero a la memoria previamente asignada por este administrador de memoria.

Comentarios

Use este método para liberar la memoria obtenida por IAtlMemMgr::Allocate o IAtlMemMgr::Reallocate.

Ejemplo

Para obtener un ejemplo, consulte información general sobre IAtlMemMgr.

IAtlMemMgr::GetSize

Llame a este método para recuperar el tamaño de un bloque de memoria asignado.

size_t GetSize(void* p) throw();

Parámetros

p
Puntero a la memoria previamente asignada por este administrador de memoria.

Valor devuelto

Devuelve el tamaño del bloque de memoria en bytes.

Ejemplo

Para obtener un ejemplo, consulte información general sobre IAtlMemMgr.

IAtlMemMgr::Reallocate

Llame a este método para reasignar la memoria asignada por este administrador de memoria.

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

Parámetros

p
Puntero a la memoria previamente asignada por este administrador de memoria.

nBytes
Número de bytes solicitado en el nuevo bloque de memoria.

Valor devuelto

Devuelve un puntero al principio del bloque de memoria recién asignado.

Comentarios

Llame a IAtlMemMgr::Free oIAtlMemMgr::Reallocate para liberar la memoria asignada por este método.

Teóricamente, este método libera la memoria existente y asigna un nuevo bloque de memoria. En realidad, la memoria existente se puede ampliar o reutilizar de otra manera.

Ejemplo

Para obtener un ejemplo, consulte información general sobre IAtlMemMgr.

IAxWinAmbientDispatch::get_AllowContextMenu

La propiedad AllowContextMenu especifica si el control hospedado puede mostrar su propio menú contextual.

STDMETHOD(get_AllowContextMenu)(VARIANT_BOOL* pbAllowContextMenu);

Parámetros

pbAllowContextMenu
[out] Dirección de una variable para recibir el valor actual de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa VARIANT_TRUE como valor predeterminado en esta propiedad.

IAxWinAmbientDispatch::get_AllowShowUI

La propiedad AllowShowUI especifica si el control hospedado puede mostrar su propia interfaz de usuario.

STDMETHOD(get_AllowShowUI)(VARIANT_BOOL* pbAllowShowUI);

Parámetros

pbAllowShowUI
[out] Dirección de una variable para recibir el valor actual de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa VARIANT_FALSE como valor predeterminado en esta propiedad.

IAxWinAmbientDispatch::get_AllowWindowlessActivation

La propiedad AllowWindowlessActivation especifica si el contenedor permitirá la activación sin ventanas.

STDMETHOD(get_AllowWindowlessActivation)(VARIANT_BOOL* pbAllowWindowless);

Parámetros

pbAllowWindowless
[out] Dirección de una variable para recibir el valor actual de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa VARIANT_TRUE como valor predeterminado en esta propiedad.

IAxWinAmbientDispatch::get_BackColor

La propiedad BackColor especifica el color de fondo ambiente del contenedor.

STDMETHOD(get_BackColor)(OLE_COLOR* pclrBackground);

Parámetros

pclrBackground
[out] Dirección de una variable para recibir el valor actual de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa COLOR_BTNFACE o COLOR_WINDOW como valor predeterminado de esta propiedad (dependiendo de si el elemento primario de la ventana host es un diálogo o no).

IAxWinAmbientDispatch::get_DisplayAsDefault

DisplayAsDefault es una propiedad de ambiente que permite a un control averiguar si el control es predeterminado.

STDMETHOD(get_DisplayAsDefault)(VARIANT_BOOL* pbDisplayAsDefault);

Parámetros

pbDisplayAsDefault
[out] Dirección de una variable para recibir el valor actual de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa VARIANT_FALSE como valor predeterminado en esta propiedad.

IAxWinAmbientDispatch::get_DocHostDoubleClickFlags

La propiedad DocHostDoubleClickFlags especifica la operación que debe realizarse en respuesta a un doble clic.

STDMETHOD(get_DocHostDoubleClickFlags)(DWORD* pdwDocHostDoubleClickFlags);

Parámetros

pdwDocHostDoubleClickFlags
[out] Dirección de una variable para recibir el valor actual de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa DOCHOSTUIDBLCLK_DEFAULT como valor predeterminado de esta propiedad.

IAxWinAmbientDispatch::get_DocHostFlags

La propiedad DocHostFlags especifica las funcionalidades de la interfaz de usuario del objeto host.

STDMETHOD(get_DocHostFlags)(DWORD* pdwDocHostFlags);

Parámetros

pdwDocHostFlags
[out] Dirección de una variable para recibir el valor actual de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa DOCHOSTUIFLAG_NO3DBORDER como valor predeterminado de esta propiedad.

IAxWinAmbientDispatch::get_Font

La propiedad Font especifica la fuente ambiente del contenedor.

STDMETHOD(get_Font)(IFontDisp** pFont);

Parámetros

pFont
[out] Dirección de un puntero de interfaz IFontDisp usado para recibir el valor actual de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa la fuente de GUI predeterminada o la fuente del sistema como valor predeterminado de esta propiedad.

IAxWinAmbientDispatch::get_ForeColor

La propiedad ForeColor especifica el color de primer plano de ambiente del contenedor.

STDMETHOD(get_ForeColor)(OLE_COLOR* pclrForeground);

Parámetros

pclrForeground
[out] Dirección de una variable para recibir el valor actual de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa el color de texto de la ventana del sistema como valor predeterminado de esta propiedad.

IAxWinAmbientDispatch::get_LocaleID

La propiedad LocaleID especifica el id. de configuración local de ambiente del contenedor.

STDMETHOD(get_LocaleID)(LCID* plcidLocaleID);

Parámetros

plcidLocaleID
[out] Dirección de una variable para recibir el valor actual de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa la configuración local predeterminada del usuario como valor predeterminado de esta propiedad.

Con este método puede descubrir el LocalID de ambiente, es decir, el LocaleID del programa en el que se está usando su control. Una vez que conozca el LocaleID, puede llamar al código para cargar subtítulos específicos de la configuración local, el texto del mensaje de error, etc. desde un archivo de recursos o un archivo DLL satélite.

IAxWinAmbientDispatch::get_MessageReflect

La propiedad ambiente MessageReflect especifica si el contenedor reflejará los mensajes en el control hospedado.

STDMETHOD(get_MessageReflect)(VARIANT_BOOL* pbMessageReflect);

Parámetros

pbMessageReflect
[out] Dirección de una variable para recibir el valor actual de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa VARIANT_TRUE como valor predeterminado en esta propiedad.

IAxWinAmbientDispatch::get_OptionKeyPath

La propiedadOptionKeyPath especifica la ruta de acceso de la clave del Registro a la configuración de usuario.

STDMETHOD(get_OptionKeyPath)(BSTR* pbstrOptionKeyPath);

Parámetros

pbstrOptionKeyPath
[out] Dirección de una variable para recibir el valor actual de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

IAxWinAmbientDispatch::get_ShowGrabHandles

La propiedad ambienteShowGrabHandles permite al control averiguar si debe dibujar controladores de arrastre.

STDMETHOD(get_ShowGrabHandles)(VARIANT_BOOL* pbShowGrabHandles);

Parámetros

pbShowGrabHandles
[out] Dirección de una variable para recibir el valor actual de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL siempre devuelve VARIANT_FALSE como valor de esta propiedad.

IAxWinAmbientDispatch::get_ShowHatching

La ShowHatching propiedad ambiente permite que el control averigüe si debe dibujase con sombreado.

STDMETHOD(get_ShowHatching)(VARIANT_BOOL* pbShowHatching);

Parámetros

pbShowHatching
[out] Dirección de una variable para recibir el valor actual de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL siempre devuelve VARIANT_FALSE como valor de esta propiedad.

IAxWinAmbientDispatch::get_UserMode

La propiedad UserMode especifica el modo de usuario ambiente del contenedor.

STDMETHOD(get_UserMode)(VARIANT_BOOL* pbUserMode);

Parámetros

pbUserMode
[out] Dirección de una variable para recibir el valor actual de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa VARIANT_TRUE como valor predeterminado en esta propiedad.

IAxWinAmbientDispatch::put_AllowContextMenu

La propiedad AllowContextMenu especifica si el control hospedado puede mostrar su propio menú contextual.

STDMETHOD(put_AllowContextMenu)(VARIANT_BOOL bAllowContextMenu);

Parámetros

bAllowContextMenu
[in] El nuevo valor de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa VARIANT_TRUE como valor predeterminado en esta propiedad.

IAxWinAmbientDispatch::put_AllowShowUI

La propiedad AllowShowUI especifica si el control hospedado puede mostrar su propia interfaz de usuario.

STDMETHOD(put_AllowShowUI)(VARIANT_BOOL bAllowShowUI);

Parámetros

bAllowShowUI
[in] El nuevo valor de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa VARIANT_FALSE como valor predeterminado en esta propiedad.

IAxWinAmbientDispatch::put_AllowWindowlessActivation

La propiedad AllowWindowlessActivation especifica si el contenedor permitirá la activación sin ventanas.

STDMETHOD(put_AllowWindowlessActivation)(VARIANT_BOOL bAllowWindowless);

Parámetros

bAllowWindowless
[in] El nuevo valor de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa VARIANT_TRUE como valor predeterminado en esta propiedad.

IAxWinAmbientDispatch::put_BackColor

La propiedad BackColor especifica el color de fondo ambiente del contenedor.

STDMETHOD(put_BackColor)(OLE_COLOR clrBackground);

Parámetros

clrBackground
[in] El nuevo valor de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa COLOR_BTNFACE o COLOR_WINDOW como valor predeterminado de esta propiedad (dependiendo de si el elemento primario de la ventana host es un diálogo o no).

IAxWinAmbientDispatch::put_DisplayAsDefault

DisplayAsDefault es una propiedad de ambiente que permite a un control averiguar si el control es predeterminado.

STDMETHOD(put_DisplayAsDefault)(VARIANT_BOOL bDisplayAsDefault);

Parámetros

bDisplayAsDefault
[in] El nuevo valor de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa VARIANT_FALSE como valor predeterminado en esta propiedad.

IAxWinAmbientDispatch::put_DocHostDoubleClickFlags

La propiedad DocHostDoubleClickFlags especifica la operación que debe realizarse en respuesta a un doble clic.

STDMETHOD(put_DocHostDoubleClickFlags)(DWORD dwDocHostDoubleClickFlags);

Parámetros

dwDocHostDoubleClickFlags
[in] El nuevo valor de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa DOCHOSTUIDBLCLK_DEFAULT como valor predeterminado de esta propiedad.

IAxWinAmbientDispatch::put_DocHostFlags

La propiedad DocHostFlags especifica las funcionalidades de la interfaz de usuario del objeto host.

STDMETHOD(put_DocHostFlags)(DWORD dwDocHostFlags);

Parámetros

dwDocHostFlags
[in] El nuevo valor de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa DOCHOSTUIFLAG_NO3DBORDER como valor predeterminado de esta propiedad.

IAxWinAmbientDispatch::put_Font

La propiedad Font especifica la fuente ambiente del contenedor.

STDMETHOD(put_Font)(IFontDisp* pFont);

Parámetros

pFont
[in] El nuevo valor de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa la fuente de GUI predeterminada o la fuente del sistema como valor predeterminado de esta propiedad.

IAxWinAmbientDispatch::put_ForeColor

La propiedad ForeColor especifica el color de primer plano de ambiente del contenedor.

STDMETHOD(put_ForeColor)(OLE_COLOR clrForeground);

Parámetros

clrForeground
[in] El nuevo valor de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa el color de texto de la ventana del sistema como valor predeterminado de esta propiedad.

IAxWinAmbientDispatch::put_LocaleID

La propiedad LocaleID especifica el id. de configuración local de ambiente del contenedor.

STDMETHOD(put_LocaleID)(LCID lcidLocaleID);

Parámetros

lcidLocaleID
[in] El nuevo valor de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa la configuración local predeterminada del usuario como valor predeterminado de esta propiedad.

IAxWinAmbientDispatch::put_MessageReflect

La propiedad ambiente MessageReflect especifica si el contenedor reflejará los mensajes en el control hospedado.

STDMETHOD(put_MessageReflect)(VARIANT_BOOL bMessageReflect);

Parámetros

bMessageReflect
[in] El nuevo valor de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa VARIANT_TRUE como valor predeterminado en esta propiedad.

IAxWinAmbientDispatch::put_OptionKeyPath

La propiedadOptionKeyPath especifica la ruta de acceso de la clave del Registro a la configuración de usuario.

STDMETHOD(put_OptionKeyPath)(BSTR bstrOptionKeyPath);

Parámetros

bstrOptionKeyPath
[in] El nuevo valor de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

IAxWinAmbientDispatch::put_UserMode

La propiedad UserMode especifica el modo de usuario ambiente del contenedor.

STDMETHOD(put_UserMode)(VARIANT_BOOL bUserMode);

Parámetros

bUserMode
[in] El nuevo valor de esta propiedad.

Valor devuelto

Valor HRESULT estándar.

Comentarios

La implementación del objeto host ATL usa VARIANT_TRUE como valor predeterminado en esta propiedad.

IAxWinAmbientDispatchEx::SetAmbientDispatch

Se llama a este método para complementar la interfaz de propiedad de ambiente predeterminada con una interfaz definida por el usuario.

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

Parámetros

pDispatch
Puntero a la nueva interfaz .

Valor devuelto

Devuelve S_OK si es correcto o un error HRESULT en caso de error.

Comentarios

Cuando se llama SetAmbientDispatch con un puntero a una nueva interfaz, esta se usará para invocar a las propiedades o métodos solicitados por el control hospedado, si IAxWinAmbientDispatch no proporciona esas propiedades.

IAxWinHostWindow::AttachControl

Asocia un control existente (y previamente inicializado) al objeto host mediante la ventana identificada por hWnd.

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

Parámetros

pUnkControl
[in] Puntero a la interfaz IUnknown del control que se va a asociar al objeto host.

hWnd
[in] Manipulador de la ventana que se va a usar para el hospedaje.

Valor devuelto

Valor HRESULT estándar.

IAxWinHostWindow::CreateControl

Crea un control, lo inicializa y lo hospeda en la ventana identificada por hWnd.

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

Parámetros

lpTricsData
[in] Cadena que identifica el control que se va a crear. Puede ser CLSID (debe incluir las llaves), ProgID, URL o HTML sin formato (con el prefijo MSHTML:).

hWnd
[in] Manipulador de la ventana que se va a usar para el hospedaje.

pStream
[in] Puntero de interfaz de un flujo que contiene datos de inicialización para el control. Puede ser NULL.

Valor devuelto

Valor HRESULT estándar.

Comentarios

El objeto host que expone esta interfaz creará una subclase de este ventana para que los mensajes se puedan reflejar en el control y funcionen otras características del contenedor.

Llamar a este método es equivalente a llamar a IAxWinHostWindow::CreateControlEx.

Para crear un control ActiveX con licencia, consulte IAxWinHostWindowLic::CreateControlLic.

IAxWinHostWindow::CreateControlEx

Crea un control ActiveX, lo inicializa y lo hospeda en la ventana especificada, de forma similar a IAxWinHostWindow::CreateControl.

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

Parámetros

lpTricsData
[in] Cadena que identifica el control que se va a crear. Puede ser CLSID (debe incluir las llaves), ProgID, URL o HTML sin formato (con el prefijo MSHTML:).

hWnd
[in] Manipulador de la ventana que se va a usar para el hospedaje.

pStream
[in] Puntero de interfaz de un flujo que contiene datos de inicialización para el control. Puede ser NULL.

ppUnk
[out] Dirección de un puntero que recibirá la interfaz IUnknown del control creado. Puede ser NULL.

riidAdvise
[in] El identificador de interfaz de una interfaz de salida en el objeto contenido. Puede ser IID_NULL.

punkAdvise
[in] Puntero a la interfaz IUnknown del objeto receptor que se va a conectar al punto de conexión en el objeto contenido especificado por iidSink.

Valor devuelto

Valor HRESULT estándar.

Comentarios

A diferencia del método CreateControl, CreateControlEx también permite recibir un puntero de interfaz al control recién creado y configurar un receptor de eventos para recibir los eventos desencadenados por el control.

Para crear un control ActiveX con licencia, consulte IAxWinHostWindowLic::CreateControlLicEx.

IAxWinHostWindow::QueryControl

Devuelve el puntero de interfaz especificado que ha proporcionado el control hospedado.

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

Parámetros

riid
[in] Identificador de una interfaz del control que se solicita.

ppvObject
[out] Dirección de un puntero que recibirá la interfaz especificada del control creado.

Valor devuelto

Valor HRESULT estándar.

IAxWinHostWindow::SetExternalDispatch

Establece el elemento dispinterface externo, que está disponible para los controles contenidos mediante el método IDocHostUIHandlerDispatch::GetExternal.

STDMETHOD(SetExternalDispatch)(IDispatch* pDisp);

Parámetros

pDisp
[in] Puntero a una interfaz IDispatch.

Valor devuelto

Valor HRESULT estándar.

IAxWinHostWindow::SetExternalUIHandler

Llame a esta función para establecer la interfaz externa IDocHostUIHandlerDispatch para el objetoCAxWindow.

STDMETHOD(SetExternalUIHandler)(IDocHostUIHandlerDispatch* pDisp);

Parámetros

pDisp
[in] Puntero a una interfaz IDocHostUIHandlerDispatch.

Valor devuelto

Valor HRESULT estándar.

Comentarios

Esta función la usan los controles (como el control de explorador web) que consultan el sitio del host para la interfaz IDocHostUIHandlerDispatch.

IAxWinHostWindowLic::CreateControlLic

Crea un control con licencia, lo inicializa y lo hospeda en la ventana identificada por hWnd.

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

Parámetros

bstrLic
[in] El parámetro BSTR que contiene la clave de licencia del control.

Comentarios

Consulte IAxWinHostWindow::CreateControl para obtener una descripción de los parámetros restantes y del valor devuelto.

Llamar a este método es equivalente a llamar a IAxWinHostWindowLic::CreateControlLicEx

Ejemplo

Consulte Hospedar controles ActiveX mediante ATL AXHost para obtener un ejemplo que utilice IAxWinHostWindowLic::CreateControlLic.

IAxWinHostWindowLic::CreateControlLicEx

Crea un control ActiveX con licencia, lo inicializa y lo hospeda en la ventana especificada, de forma similar a IAxWinHostWindow::CreateControl.

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

Parámetros

bstrLic
[in] El parámetro BSTR que contiene la clave de licencia del control.

Comentarios

Consulte IAxWinHostWindow::CreateControlEx para obtener una descripción de los parámetros restantes y del valor devuelto.

Ejemplo

Consulte Hospedar controles ActiveX mediante ATL AXHost para obtener un ejemplo que utilice IAxWinHostWindowLic::CreateControlLicEx.

Consulte también

Información general sobre la clase