Поделиться через


Класс 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_MessageРефлексия

Свойство MessageReflect окружения указывает, будет ли контейнер отражать сообщения размещенного элемента управления.

STDMETHOD(get_MessageReflect)(VARIANT_BOOL* pbMessageReflect);

Параметры

pbMessage Рефлексия
[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_Message Рефлексия

Свойство MessageReflect окружения указывает, будет ли контейнер отражать сообщения размещенного элемента управления.

STDMETHOD(put_MessageReflect)(VARIANT_BOOL bMessageReflect);

Параметры

bMessage Рефлексия
[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".

См. также

Общие сведения о классе