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
.