Класс IAtlMemMgr
Этот класс представляет интерфейс диспетчера памяти.
Синтаксис
__interface __declspec(uuid("654F7EF5-CFDF-4df9-A450-6C6A13C622C0")) IAtlMemMgr
Участники
Методы
Имя | Описание |
---|---|
Размещать | Вызовите этот метод, чтобы выделить блок памяти. |
Бесплатно | Вызовите этот метод, чтобы освободить блок памяти. |
GetSize | Вызовите этот метод, чтобы получить размер выделенного блока памяти. |
Перераспределить | Вызовите этот метод, чтобы перераспределить блок памяти. |
Замечания
Этот интерфейс реализуется CComHeap, CCRTHeap, CLocalHeap, CGlobalHeap или CWin32Heap.
Примечание.
Локальные и глобальные функции кучи медленнее других функций управления памятью и не предоставляют столько функций. Поэтому новые приложения должны использовать функции кучи. Они доступны в классе CWin32Heap .
Пример
// 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;
}
Требования
Заголовок: atlmem.h
IAtlMemMgr::Allocate
Вызовите этот метод, чтобы выделить блок памяти.
void* Allocate(size_t nBytes) throw();
Параметры
nBytes
Запрошенное число байтов в новом блоке памяти.
Возвращаемое значение
Возвращает указатель на начало выделенного блока памяти.
Замечания
Вызовите IAtlMemMgr::Free или IAtlMemMgr::Reallocate , чтобы освободить память, выделенную этим методом.
Пример
Пример см. в обзоре IAtlMemMgr.
IAtlMemMgr::Free
Вызовите этот метод, чтобы освободить блок памяти.
void Free(void* p) throw();
Параметры
p
Указатель на область памяти, выделенную ранее данным диспетчером памяти.
Замечания
Используйте этот метод для освобождения памяти, полученной IAtlMemMgr::Allocate или IAtlMemMgr::Reallocate.
Пример
Пример см. в обзоре IAtlMemMgr.
IAtlMemMgr::GetSize
Вызовите этот метод, чтобы получить размер выделенного блока памяти.
size_t GetSize(void* p) throw();
Параметры
p
Указатель на область памяти, выделенную ранее данным диспетчером памяти.
Возвращаемое значение
Возвращает размер блока памяти в байтах.
Пример
Пример см. в обзоре IAtlMemMgr.
IAtlMemMgr::Reallocate
Вызовите этот метод для перераспределения памяти, выделенной данным диспетчером памяти.
void* Reallocate(void* p, size_t nBytes) throw();
Параметры
p
Указатель на область памяти, выделенную ранее данным диспетчером памяти.
nBytes
Запрошенное число байтов в новом блоке памяти.
Возвращаемое значение
Возвращает указатель на начало выделенного блока памяти.
Замечания
Вызовите IAtlMemMgr::Free или IAtlMemMgr::Reallocate , чтобы освободить память, выделенную этим методом.
Концептуально этот метод освобождает существующую память и выделяет новый блок памяти. В действительности существующая память может быть расширена или повторно использована.
Пример
Пример см. в обзоре IAtlMemMgr.
IAxWinAmbientDispatch::get_AllowContextMenu
Свойство AllowContextMenu
указывает, разрешено ли размещенное управление отображать собственное контекстное меню.
STDMETHOD(get_AllowContextMenu)(VARIANT_BOOL* pbAllowContextMenu);
Параметры
pbAllowContextMenu
[out] Адрес переменной для получения текущего значения этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует VARIANT_TRUE в качестве значения по умолчанию этого свойства.
IAxWinAmbientDispatch::get_AllowShowUI
Свойство AllowShowUI
указывает, разрешено ли размещенное элементу управления отображать собственный пользовательский интерфейс.
STDMETHOD(get_AllowShowUI)(VARIANT_BOOL* pbAllowShowUI);
Параметры
pbAllowShowUI
[out] Адрес переменной для получения текущего значения этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует VARIANT_FALSE в качестве значения по умолчанию этого свойства.
IAxWinAmbientDispatch::get_AllowWindowlessActivation
Свойство AllowWindowlessActivation
указывает, будет ли контейнер разрешать активацию без окон.
STDMETHOD(get_AllowWindowlessActivation)(VARIANT_BOOL* pbAllowWindowless);
Параметры
pbAllowWindowless
[out] Адрес переменной для получения текущего значения этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует VARIANT_TRUE в качестве значения по умолчанию этого свойства.
IAxWinAmbientDispatch::get_BackColor
Свойство BackColor
указывает внешний цвет фона контейнера.
STDMETHOD(get_BackColor)(OLE_COLOR* pclrBackground);
Параметры
pclrBackground
[out] Адрес переменной для получения текущего значения этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует COLOR_BTNFACE или COLOR_WINDOW в качестве значения по умолчанию этого свойства (в зависимости от того, является ли родительский элемент окна узла диалогом или нет).
IAxWinAmbientDispatch::get_DisplayAsDefault
DisplayAsDefault
— это внешнее свойство, позволяющее элементу управления определить, является ли он элементом управления по умолчанию.
STDMETHOD(get_DisplayAsDefault)(VARIANT_BOOL* pbDisplayAsDefault);
Параметры
pbDisplayAsDefault
[out] Адрес переменной для получения текущего значения этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует VARIANT_FALSE в качестве значения по умолчанию этого свойства.
IAxWinAmbientDispatch::get_DocHostDoubleClickFlags
Свойство DocHostDoubleClickFlags
указывает операцию, которая должна выполняться в ответ на двойной щелчок.
STDMETHOD(get_DocHostDoubleClickFlags)(DWORD* pdwDocHostDoubleClickFlags);
Параметры
pdwDocHostDoubleClickFlags
[out] Адрес переменной для получения текущего значения этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует DOCHOSTUIDBLCLK_DEFAULT в качестве значения по умолчанию этого свойства.
IAxWinAmbientDispatch::get_DocHostFlags
Свойство DocHostFlags
задает возможности пользовательского интерфейса объекта узла.
STDMETHOD(get_DocHostFlags)(DWORD* pdwDocHostFlags);
Параметры
pdwDocHostFlags
[out] Адрес переменной для получения текущего значения этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует DOCHOSTUIFLAG_NO3DBORDER в качестве значения по умолчанию этого свойства.
IAxWinAmbientDispatch::get_Font
Свойство Font
задает внешний шрифт контейнера.
STDMETHOD(get_Font)(IFontDisp** pFont);
Параметры
pFont
[out] Адрес указателя интерфейса, используемый IFontDisp
для получения текущего значения этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует шрифт графического интерфейса по умолчанию или системный шрифт в качестве значения по умолчанию этого свойства.
IAxWinAmbientDispatch::get_ForeColor
Свойство ForeColor
задает внешний цвет переднего плана контейнера.
STDMETHOD(get_ForeColor)(OLE_COLOR* pclrForeground);
Параметры
pclrForeground
[out] Адрес переменной для получения текущего значения этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует цвет текста системного окна в качестве значения по умолчанию этого свойства.
IAxWinAmbientDispatch::get_LocaleID
Свойство LocaleID
задает идентификатор внешнего языкового стандарта контейнера.
STDMETHOD(get_LocaleID)(LCID* plcidLocaleID);
Параметры
plcidLocaleID
[out] Адрес переменной для получения текущего значения этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует языковой стандарт пользователя по умолчанию в качестве значения по умолчанию этого свойства.
С помощью этого метода можно обнаружить ambient LocalID, то есть localeID программы, в которой используется ваш элемент управления. После того как вы знаете LocaleID, можно вызвать код для загрузки подписей для языкового стандарта, текста сообщения об ошибке и т. д. из файла ресурсов или вспомогательной библиотеки DLL.
IAxWinAmbientDispatch::get_MessageReflect
Свойство MessageReflect
окружения указывает, будет ли контейнер отражать сообщения размещенного элемента управления.
STDMETHOD(get_MessageReflect)(VARIANT_BOOL* pbMessageReflect);
Параметры
pbMessageReflect
[out] Адрес переменной для получения текущего значения этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует VARIANT_TRUE в качестве значения по умолчанию этого свойства.
IAxWinAmbientDispatch::get_OptionKeyPath
Свойство OptionKeyPath
указывает путь к разделу реестра к параметрам пользователя.
STDMETHOD(get_OptionKeyPath)(BSTR* pbstrOptionKeyPath);
Параметры
pbstrOptionKeyPath
[out] Адрес переменной для получения текущего значения этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
IAxWinAmbientDispatch::get_ShowGrabHandles
Внешнее ShowGrabHandles
свойство позволяет элементу управления выяснить, следует ли рисовать себя с помощью дескрипторов захвата.
STDMETHOD(get_ShowGrabHandles)(VARIANT_BOOL* pbShowGrabHandles);
Параметры
pbShowGrabHandles
[out] Адрес переменной для получения текущего значения этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL всегда возвращает VARIANT_FALSE в качестве значения этого свойства.
IAxWinAmbientDispatch::get_ShowHatching
Внешнее ShowHatching
свойство позволяет элементу управления узнать, следует ли рисовать себя вылупленным.
STDMETHOD(get_ShowHatching)(VARIANT_BOOL* pbShowHatching);
Параметры
pbShowHatching
[out] Адрес переменной для получения текущего значения этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL всегда возвращает VARIANT_FALSE в качестве значения этого свойства.
IAxWinAmbientDispatch::get_UserMode
Свойство UserMode
задает внешний пользовательский режим контейнера.
STDMETHOD(get_UserMode)(VARIANT_BOOL* pbUserMode);
Параметры
pbUserMode
[out] Адрес переменной для получения текущего значения этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует VARIANT_TRUE в качестве значения по умолчанию этого свойства.
IAxWinAmbientDispatch::p ut_AllowContextMenu
Свойство AllowContextMenu
указывает, разрешено ли размещенное управление отображать собственное контекстное меню.
STDMETHOD(put_AllowContextMenu)(VARIANT_BOOL bAllowContextMenu);
Параметры
bAllowContextMenu
[in] Новое значение этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует VARIANT_TRUE в качестве значения по умолчанию этого свойства.
IAxWinAmbientDispatch::p ut_AllowShowUI
Свойство AllowShowUI
указывает, разрешено ли размещенное элементу управления отображать собственный пользовательский интерфейс.
STDMETHOD(put_AllowShowUI)(VARIANT_BOOL bAllowShowUI);
Параметры
bAllowShowUI
[in] Новое значение этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует VARIANT_FALSE в качестве значения по умолчанию этого свойства.
IAxWinAmbientDispatch::p ut_AllowWindowlessActivation
Свойство AllowWindowlessActivation
указывает, будет ли контейнер разрешать активацию без окон.
STDMETHOD(put_AllowWindowlessActivation)(VARIANT_BOOL bAllowWindowless);
Параметры
bAllowWindowless
[in] Новое значение этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует VARIANT_TRUE в качестве значения по умолчанию этого свойства.
IAxWinAmbientDispatch::p ut_BackColor
Свойство BackColor
указывает внешний цвет фона контейнера.
STDMETHOD(put_BackColor)(OLE_COLOR clrBackground);
Параметры
clrBackground
[in] Новое значение этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует COLOR_BTNFACE или COLOR_WINDOW в качестве значения по умолчанию этого свойства (в зависимости от того, является ли родительский элемент окна узла диалогом или нет).
IAxWinAmbientDispatch::p ut_DisplayAsDefault
DisplayAsDefault
— это внешнее свойство, позволяющее элементу управления определить, является ли он элементом управления по умолчанию.
STDMETHOD(put_DisplayAsDefault)(VARIANT_BOOL bDisplayAsDefault);
Параметры
bDisplayAsDefault
[in] Новое значение этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует VARIANT_FALSE в качестве значения по умолчанию этого свойства.
IAxWinAmbientDispatch::p ut_DocHostDoubleClickFlags
Свойство DocHostDoubleClickFlags
указывает операцию, которая должна выполняться в ответ на двойной щелчок.
STDMETHOD(put_DocHostDoubleClickFlags)(DWORD dwDocHostDoubleClickFlags);
Параметры
dwDocHostDoubleClickFlags
[in] Новое значение этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует DOCHOSTUIDBLCLK_DEFAULT в качестве значения по умолчанию этого свойства.
IAxWinAmbientDispatch::p ut_DocHostFlags
Свойство DocHostFlags
задает возможности пользовательского интерфейса объекта узла.
STDMETHOD(put_DocHostFlags)(DWORD dwDocHostFlags);
Параметры
dwDocHostFlags
[in] Новое значение этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует DOCHOSTUIFLAG_NO3DBORDER в качестве значения по умолчанию этого свойства.
IAxWinAmbientDispatch::p ut_Font
Свойство Font
задает внешний шрифт контейнера.
STDMETHOD(put_Font)(IFontDisp* pFont);
Параметры
pFont
[in] Новое значение этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует шрифт графического интерфейса по умолчанию или системный шрифт в качестве значения по умолчанию этого свойства.
IAxWinAmbientDispatch::p ut_ForeColor
Свойство ForeColor
задает внешний цвет переднего плана контейнера.
STDMETHOD(put_ForeColor)(OLE_COLOR clrForeground);
Параметры
clrForeground
[in] Новое значение этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует цвет текста системного окна в качестве значения по умолчанию этого свойства.
IAxWinAmbientDispatch::p ut_LocaleID
Свойство LocaleID
задает идентификатор внешнего языкового стандарта контейнера.
STDMETHOD(put_LocaleID)(LCID lcidLocaleID);
Параметры
lcidLocaleID
[in] Новое значение этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует языковой стандарт пользователя по умолчанию в качестве значения по умолчанию этого свойства.
IAxWinAmbientDispatch::p ut_MessageReflect
Свойство MessageReflect
окружения указывает, будет ли контейнер отражать сообщения размещенного элемента управления.
STDMETHOD(put_MessageReflect)(VARIANT_BOOL bMessageReflect);
Параметры
bMessageReflect
[in] Новое значение этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует VARIANT_TRUE в качестве значения по умолчанию этого свойства.
IAxWinAmbientDispatch::p ut_OptionKeyPath
Свойство OptionKeyPath
указывает путь к разделу реестра к параметрам пользователя.
STDMETHOD(put_OptionKeyPath)(BSTR bstrOptionKeyPath);
Параметры
bstrOptionKeyPath
[in] Новое значение этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
IAxWinAmbientDispatch::p ut_UserMode
Свойство UserMode
задает внешний пользовательский режим контейнера.
STDMETHOD(put_UserMode)(VARIANT_BOOL bUserMode);
Параметры
bUserMode
[in] Новое значение этого свойства.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Реализация объекта узла ATL использует VARIANT_TRUE в качестве значения по умолчанию этого свойства.
IAxWinAmbientDispatchEx::SetAmbientDispatch
Этот метод вызывается для дополнения интерфейса внешнего свойства по умолчанию с пользовательским интерфейсом.
virtual HRESULT STDMETHODCALLTYPE SetAmbientDispatch(IDispatch* pDispatch) = 0;
Параметры
pDispatch
Указатель на новый интерфейс.
Возвращаемое значение
Возвращает S_OK при успешном выполнении или ошибку HRESULT при сбое.
Замечания
При SetAmbientDispatch
вызове указателя на новый интерфейс этот новый интерфейс будет использоваться для вызова любых свойств или методов, запрашиваемых размещенным элементом управления, если эти свойства еще не предоставлены IAxWinAmbientDispatch.
IAxWinHostWindow::AttachControl
Присоединяет существующий (и ранее инициализированный) элемент управления к объекту узла с помощью окна, определяемого hWnd.
STDMETHOD(AttachControl)(IUnknown* pUnkControl, HWND hWnd);
Параметры
pUnkControl
[in] Указатель на IUnknown
интерфейс элемента управления, присоединенного к объекту узла.
hWnd
[in] Дескриптор окна, который будет использоваться для размещения.
Возвращаемое значение
Стандартное значение HRESULT.
IAxWinHostWindow::CreateControl
Создает элемент управления, инициализирует его и размещает его в окне, определяемом hWnd.
STDMETHOD(CreateControl)(
LPCOLESTR lpTricsData,
HWND hWnd,
IStream* pStream);
Параметры
lpTricsData
[in] Строка, определяющая элемент управления для создания. Может быть CLSID (должен включать фигурные скобки), ProgID, URL-адрес или необработанный HTML (префикс MSHTML :).
hWnd
[in] Дескриптор окна, который будет использоваться для размещения.
pStream
[in] Указатель интерфейса для потока, содержащего данные инициализации для элемента управления. Может иметь значение NULL.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Это окно будет подклассировано объектом узла, предоставляющим этот интерфейс, чтобы сообщения могли отражаться в элементе управления, а другие функции контейнера будут работать.
Вызов этого метода эквивалентен вызову IAxWinHostWindow::CreateControlEx.
Сведения о создании лицензированного элемента ActiveX см. в разделе IAxWinHostWindowLic::CreateControlLic.
IAxWinHostWindow::CreateControlEx
Создает элемент ActiveX, инициализирует его и размещает его в указанном окне, аналогично IAxWinHostWindow::CreateControl.
STDMETHOD(CreateControlEx)(
LPCOLESTR lpszTricsData,
HWND hWnd,
IStream* pStream,
IUnknown** ppUnk,
REFIID riidAdvise,
IUnknown* punkAdvise);
Параметры
lpTricsData
[in] Строка, определяющая элемент управления для создания. Может быть CLSID (должен включать фигурные скобки), ProgID, URL-адрес или необработанный HTML (префикс с ПОМОЩЬЮ MSHTML:).
hWnd
[in] Дескриптор окна, который будет использоваться для размещения.
pStream
[in] Указатель интерфейса для потока, содержащего данные инициализации для элемента управления. Может иметь значение NULL.
ppUnk
[out] Адрес указателя, который получит IUnknown
интерфейс созданного элемента управления. Может иметь значение NULL.
riidAdvise
[in] Идентификатор интерфейса исходящего интерфейса в содержащемся объекте. Можно IID_NULL.
punkAdvise
[in] Указатель на IUnknown
интерфейс объекта приемника, который должен быть подключен к точке подключения к автономному объекту, указанному iidSink
.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
CreateControl
В отличие от метода, CreateControlEx
вы также можете получить указатель интерфейса на только что созданный элемент управления и настроить приемник событий для получения событий, запущенных элементом управления.
Сведения о создании лицензированного элемента ActiveX см. в разделе IAxWinHostWindowLic::CreateControlLicEx.
IAxWinHostWindow::QueryControl
Возвращает указанный указатель интерфейса, предоставляемый размещенным элементом управления.
STDMETHOD(QueryControl)(REFIID riid, void** ppvObject);
Параметры
riid
[in] Идентификатор интерфейса для запрашиваемого элемента управления.
ppvObject
[out] Адрес указателя, который получит указанный интерфейс созданного элемента управления.
Возвращаемое значение
Стандартное значение HRESULT.
IAxWinHostWindow::SetExternalDispatch
Задает внешний dispinterface, который доступен для содержащихся элементов управления с помощью метода IDocHostUIHandlerDispatch::GetExternal .
STDMETHOD(SetExternalDispatch)(IDispatch* pDisp);
Параметры
pDisp
[in] Указатель на IDispatch
интерфейс.
Возвращаемое значение
Стандартное значение HRESULT.
IAxWinHostWindow::SetExternalUIHandler
Вызовите эту функцию, чтобы задать внешний интерфейс IDocHostUIHandlerDispatch для CAxWindow
объекта.
STDMETHOD(SetExternalUIHandler)(IDocHostUIHandlerDispatch* pDisp);
Параметры
pDisp
[in] Указатель на IDocHostUIHandlerDispatch
интерфейс.
Возвращаемое значение
Стандартное значение HRESULT.
Замечания
Эта функция используется элементами управления (например, элементом управления веб-браузером), который запрашивает сайт узла для IDocHostUIHandlerDispatch
интерфейса.
IAxWinHostWindowLic::CreateControlLic
Создает лицензированный элемент управления, инициализирует его и размещает в окне, определяемом пользователем hWnd
.
STDMETHOD(CreateControlLic)(
LPCOLESTR lpTricsData,
HWND hWnd,
IStream* pStream,
BSTR bstrLic);
Параметры
bstrLic
[in] BSTR, содержащий ключ лицензии для элемента управления.
Замечания
Описание оставшихся параметров и возвращаемого значения см. в разделе IAxWinHostWindow::CreateControl .
Вызов этого метода эквивалентен вызову IAxWinHostWindowLic::CreateControlLicEx
Пример
Пример использования IAxWinHostWindowLic::CreateControlLic
элементов ActiveX см. в разделе "Размещение элементов ActiveX Controls с помощью ATL AXHost".
IAxWinHostWindowLic::CreateControlLicEx
Создает лицензированный элемент ActiveX, инициализирует его и размещает его в указанном окне, аналогично IAxWinHostWindow::CreateControl.
STDMETHOD(CreateControlLicEx)(
LPCOLESTR lpszTricsData,
HWND hWnd,
IStream* pStream,
IUnknown** ppUnk,
REFIID riidAdvise,
IUnknown* punkAdvise,
BSTR bstrLic);
Параметры
bstrLic
[in] BSTR, содержащий ключ лицензии для элемента управления.
Замечания
Описание оставшихся параметров и возвращаемого значения см. в разделе IAxWinHostWindow::CreateControlEx .
Пример
Пример использования IAxWinHostWindowLic::CreateControlLicEx
элементов ActiveX см. в разделе "Размещение элементов ActiveX Controls с помощью ATL AXHost".