IAtlMemMgr-klasse

Deze klasse vertegenwoordigt de interface voor een geheugenbeheerder.

Syntaxis

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

Leden

Methods

Opmerkingen

Deze interface wordt geïmplementeerd door CComHeap, CCRTHeap, CLocalHeap, CGlobalHeap of CWin32Heap.

Example

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

Requirements

Koptekst: atlmem.h

IAtlMemMgr::Toewijzen

Roep deze methode aan om een blok geheugen toe te wijzen.

void* Allocate(size_t nBytes) throw();

Parameterwaarden

nBytes
Het aangevraagde aantal bytes in het nieuwe geheugenblok.

Retourwaarde

Retourneert een aanwijzer naar het begin van het zojuist toegewezen geheugenblok.

Opmerkingen

Roep IAtlMemMgr::Free of IAtlMemMgr::Reallocate aan om het geheugen vrij te maken dat door deze methode is toegewezen.

Example

Zie het overzicht van IAtlMemMgr voor een voorbeeld.

IAtlMemMgr::Free

Roep deze methode aan om een blok geheugen vrij te maken.

void Free(void* p) throw();

Parameterwaarden

p
Aanwijzer naar geheugen dat eerder door deze geheugenbeheerder is toegewezen.

Opmerkingen

Gebruik deze methode om geheugen vrij te maken dat is verkregen door IAtlMemMgr::Allocate of IAtlMemMgr::Reallocate.

Example

Zie het overzicht van IAtlMemMgr voor een voorbeeld.

IAtlMemMgr::GetSize

Roep deze methode aan om de grootte van een toegewezen geheugenblok op te halen.

size_t GetSize(void* p) throw();

Parameterwaarden

p
Aanwijzer naar geheugen dat eerder door deze geheugenbeheerder is toegewezen.

Retourwaarde

Retourneert de grootte van het geheugenblok in bytes.

Example

Zie het overzicht van IAtlMemMgr voor een voorbeeld.

IAtlMemMgr::Reallocate

Roep deze methode aan om geheugen dat door deze geheugenbeheerder is toegewezen, opnieuw toe te wijzen.

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

Parameterwaarden

p
Aanwijzer naar geheugen dat eerder door deze geheugenbeheerder is toegewezen.

nBytes
Het aangevraagde aantal bytes in het nieuwe geheugenblok.

Retourwaarde

Retourneert een aanwijzer naar het begin van het zojuist toegewezen geheugenblok.

Opmerkingen

Roep IAtlMemMgr::Free of IAtlMemMgr::Reallocate aan om het geheugen vrij te maken dat door deze methode is toegewezen.

Conceptueel wordt met deze methode het bestaande geheugen vrijgemaakt en wordt een nieuw geheugenblok toegewezen. In werkelijkheid kan het bestaande geheugen worden uitgebreid of anderszins opnieuw worden gebruikt.

Example

Zie het overzicht van IAtlMemMgr voor een voorbeeld.

IAxWinAmbientDispatch::get_AllowContextMenu

De AllowContextMenu eigenschap geeft aan of het gehoste besturingselement een eigen contextmenu mag weergeven.

STDMETHOD(get_AllowContextMenu)(VARIANT_BOOL* pbAllowContextMenu);

Parameterwaarden

pbAllowContextMenu
[uit] Het adres van een variabele om de huidige waarde van deze eigenschap te ontvangen.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject gebruikt VARIANT_TRUE als de standaardwaarde van deze eigenschap.

IAxWinAmbientDispatch::get_AllowShowUI

De AllowShowUI eigenschap geeft aan of het gehoste besturingselement een eigen gebruikersinterface mag weergeven.

STDMETHOD(get_AllowShowUI)(VARIANT_BOOL* pbAllowShowUI);

Parameterwaarden

pbAllowShowUI
[uit] Het adres van een variabele om de huidige waarde van deze eigenschap te ontvangen.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject maakt gebruik van VARIANT_FALSE als de standaardwaarde van deze eigenschap.

IAxWinAmbientDispatch::get_AllowWindowlessActivation

De AllowWindowlessActivation eigenschap geeft aan of de container vensterloze activering toestaat.

STDMETHOD(get_AllowWindowlessActivation)(VARIANT_BOOL* pbAllowWindowless);

Parameterwaarden

pbAllowWindowless
[uit] Het adres van een variabele om de huidige waarde van deze eigenschap te ontvangen.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject gebruikt VARIANT_TRUE als de standaardwaarde van deze eigenschap.

IAxWinAmbientDispatch::get_BackColor

De BackColor eigenschap geeft de achtergrondkleur van de omgeving van de container op.

STDMETHOD(get_BackColor)(OLE_COLOR* pclrBackground);

Parameterwaarden

pclrBackground
[uit] Het adres van een variabele om de huidige waarde van deze eigenschap te ontvangen.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject maakt gebruik van COLOR_BTNFACE of COLOR_WINDOW als de standaardwaarde van deze eigenschap (afhankelijk van of het bovenliggende hostvenster een dialoogvenster is of niet).

IAxWinAmbientDispatch::get_DisplayAsDefault

DisplayAsDefault is een omgevingseigenschap waarmee een besturingselement kan achterhalen of dit het standaardbesturingselement is.

STDMETHOD(get_DisplayAsDefault)(VARIANT_BOOL* pbDisplayAsDefault);

Parameterwaarden

pbDisplayAsDefault
[uit] Het adres van een variabele om de huidige waarde van deze eigenschap te ontvangen.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject maakt gebruik van VARIANT_FALSE als de standaardwaarde van deze eigenschap.

IAxWinAmbientDispatch::get_DocHostDoubleClickFlags

De DocHostDoubleClickFlags eigenschap geeft de bewerking op die moet worden uitgevoerd als reactie op een dubbelklik.

STDMETHOD(get_DocHostDoubleClickFlags)(DWORD* pdwDocHostDoubleClickFlags);

Parameterwaarden

pdwDocHostDoubleClickFlags
[uit] Het adres van een variabele om de huidige waarde van deze eigenschap te ontvangen.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject maakt gebruik van DOCHOSTUIDBLCLK_DEFAULT als de standaardwaarde van deze eigenschap.

IAxWinAmbientDispatch::get_DocHostFlags

De DocHostFlags eigenschap geeft de gebruikersinterfacemogelijkheden van het hostobject op.

STDMETHOD(get_DocHostFlags)(DWORD* pdwDocHostFlags);

Parameterwaarden

pdwDocHostFlags
[uit] Het adres van een variabele om de huidige waarde van deze eigenschap te ontvangen.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject gebruikt DOCHOSTUIFLAG_NO3DBORDER als de standaardwaarde van deze eigenschap.

IAxWinAmbientDispatch::get_Font

De Font eigenschap geeft het omgevingslettertype van de container op.

STDMETHOD(get_Font)(IFontDisp** pFont);

Parameterwaarden

pFont
[uit] Het adres van een IFontDisp interfaceaanwijzer die wordt gebruikt om de huidige waarde van deze eigenschap te ontvangen.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject maakt gebruik van het standaard-GUI-lettertype of het systeemlettertype als de standaardwaarde van deze eigenschap.

IAxWinAmbientDispatch::get_ForeColor

De ForeColor eigenschap geeft de omgevingskleur van de container op.

STDMETHOD(get_ForeColor)(OLE_COLOR* pclrForeground);

Parameterwaarden

pclrForeground
[uit] Het adres van een variabele om de huidige waarde van deze eigenschap te ontvangen.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject gebruikt de tekstkleur van het systeemvenster als de standaardwaarde van deze eigenschap.

IAxWinAmbientDispatch::get_LocaleID

De LocaleID eigenschap geeft de omgevingsinstellings-id van de container op.

STDMETHOD(get_LocaleID)(LCID* plcidLocaleID);

Parameterwaarden

plcidLocaleID
[uit] Het adres van een variabele om de huidige waarde van deze eigenschap te ontvangen.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject maakt gebruik van de standaardlandinstelling van de gebruiker als de standaardwaarde van deze eigenschap.

Met deze methode kunt u de Omgevings localID ontdekken, dat wil gezegd, de LocaleID van het programma waarin uw controle wordt gebruikt. Zodra u de LocaleID kent, kunt u code aanroepen om landinstellingenspecifieke bijschriften te laden, tekst van foutberichten, enzovoort vanuit een bronbestand of satelliet-DLL.

IAxWinAmbientDispatch::get_MessageReflect

De MessageReflect omgevingseigenschap geeft aan of de container berichten weergeeft aan het gehoste besturingselement.

STDMETHOD(get_MessageReflect)(VARIANT_BOOL* pbMessageReflect);

Parameterwaarden

pbMessageReflect
[uit] Het adres van een variabele om de huidige waarde van deze eigenschap te ontvangen.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject gebruikt VARIANT_TRUE als de standaardwaarde van deze eigenschap.

IAxWinAmbientDispatch::get_OptionKeyPath

De OptionKeyPath eigenschap geeft het pad naar de registersleutel op naar gebruikersinstellingen.

STDMETHOD(get_OptionKeyPath)(BSTR* pbstrOptionKeyPath);

Parameterwaarden

pbstrOptionKeyPath
[uit] Het adres van een variabele om de huidige waarde van deze eigenschap te ontvangen.

Retourwaarde

Een standaard HRESULT-waarde.

IAxWinAmbientDispatch::get_ShowGrabHandles

Met ShowGrabHandles de omgevingseigenschap kan het besturingselement erachter komen of het zichzelf met greepgrepen moet tekenen.

STDMETHOD(get_ShowGrabHandles)(VARIANT_BOOL* pbShowGrabHandles);

Parameterwaarden

pbShowGrabHandles
[uit] Het adres van een variabele om de huidige waarde van deze eigenschap te ontvangen.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject retourneert altijd VARIANT_FALSE als de waarde van deze eigenschap.

IAxWinAmbientDispatch::get_ShowHatching

Met ShowHatching de omgevingseigenschap kan de besturing achterhalen of het zelf moet worden uitgebroed.

STDMETHOD(get_ShowHatching)(VARIANT_BOOL* pbShowHatching);

Parameterwaarden

pbShowHatching
[uit] Het adres van een variabele om de huidige waarde van deze eigenschap te ontvangen.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject retourneert altijd VARIANT_FALSE als de waarde van deze eigenschap.

IAxWinAmbientDispatch::get_UserMode

De UserMode eigenschap geeft de omgevingsgebruikersmodus van de container op.

STDMETHOD(get_UserMode)(VARIANT_BOOL* pbUserMode);

Parameterwaarden

pbUserMode
[uit] Het adres van een variabele om de huidige waarde van deze eigenschap te ontvangen.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject gebruikt VARIANT_TRUE als de standaardwaarde van deze eigenschap.

IAxWinAmbientDispatch::p ut_AllowContextMenu

De AllowContextMenu eigenschap geeft aan of het gehoste besturingselement een eigen contextmenu mag weergeven.

STDMETHOD(put_AllowContextMenu)(VARIANT_BOOL bAllowContextMenu);

Parameterwaarden

bAllowContextMenu
[in] De nieuwe waarde van deze eigenschap.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject gebruikt VARIANT_TRUE als de standaardwaarde van deze eigenschap.

IAxWinAmbientDispatch::p ut_AllowShowUI

De AllowShowUI eigenschap geeft aan of het gehoste besturingselement een eigen gebruikersinterface mag weergeven.

STDMETHOD(put_AllowShowUI)(VARIANT_BOOL bAllowShowUI);

Parameterwaarden

bAllowShowUI
[in] De nieuwe waarde van deze eigenschap.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject maakt gebruik van VARIANT_FALSE als de standaardwaarde van deze eigenschap.

IAxWinAmbientDispatch::p ut_AllowWindowlessActivation

De AllowWindowlessActivation eigenschap geeft aan of de container vensterloze activering toestaat.

STDMETHOD(put_AllowWindowlessActivation)(VARIANT_BOOL bAllowWindowless);

Parameterwaarden

bAllowWindowless
[in] De nieuwe waarde van deze eigenschap.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject gebruikt VARIANT_TRUE als de standaardwaarde van deze eigenschap.

IAxWinAmbientDispatch::p ut_BackColor

De BackColor eigenschap geeft de achtergrondkleur van de omgeving van de container op.

STDMETHOD(put_BackColor)(OLE_COLOR clrBackground);

Parameterwaarden

clrBackground
[in] De nieuwe waarde van deze eigenschap.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject maakt gebruik van COLOR_BTNFACE of COLOR_WINDOW als de standaardwaarde van deze eigenschap (afhankelijk van of het bovenliggende hostvenster een dialoogvenster is of niet).

IAxWinAmbientDispatch::p ut_DisplayAsDefault

DisplayAsDefault is een omgevingseigenschap waarmee een besturingselement kan achterhalen of dit het standaardbesturingselement is.

STDMETHOD(put_DisplayAsDefault)(VARIANT_BOOL bDisplayAsDefault);

Parameterwaarden

bDisplayAsDefault
[in] De nieuwe waarde van deze eigenschap.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject maakt gebruik van VARIANT_FALSE als de standaardwaarde van deze eigenschap.

IAxWinAmbientDispatch::p ut_DocHostDoubleClickFlags

De DocHostDoubleClickFlags eigenschap geeft de bewerking op die moet worden uitgevoerd als reactie op een dubbelklik.

STDMETHOD(put_DocHostDoubleClickFlags)(DWORD dwDocHostDoubleClickFlags);

Parameterwaarden

dwDocHostDoubleClickFlags
[in] De nieuwe waarde van deze eigenschap.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject maakt gebruik van DOCHOSTUIDBLCLK_DEFAULT als de standaardwaarde van deze eigenschap.

IAxWinAmbientDispatch::p ut_DocHostFlags

De DocHostFlags eigenschap geeft de gebruikersinterfacemogelijkheden van het hostobject op.

STDMETHOD(put_DocHostFlags)(DWORD dwDocHostFlags);

Parameterwaarden

dwDocHostFlags
[in] De nieuwe waarde van deze eigenschap.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject gebruikt DOCHOSTUIFLAG_NO3DBORDER als de standaardwaarde van deze eigenschap.

IAxWinAmbientDispatch::p ut_Font

De Font eigenschap geeft het omgevingslettertype van de container op.

STDMETHOD(put_Font)(IFontDisp* pFont);

Parameterwaarden

pFont
[in] De nieuwe waarde van deze eigenschap.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject maakt gebruik van het standaard-GUI-lettertype of het systeemlettertype als de standaardwaarde van deze eigenschap.

IAxWinAmbientDispatch::p ut_ForeColor

De ForeColor eigenschap geeft de omgevingskleur van de container op.

STDMETHOD(put_ForeColor)(OLE_COLOR clrForeground);

Parameterwaarden

clrForeground
[in] De nieuwe waarde van deze eigenschap.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject gebruikt de tekstkleur van het systeemvenster als de standaardwaarde van deze eigenschap.

IAxWinAmbientDispatch::p ut_LocaleID

De LocaleID eigenschap geeft de omgevingsinstellings-id van de container op.

STDMETHOD(put_LocaleID)(LCID lcidLocaleID);

Parameterwaarden

lcidLocaleID
[in] De nieuwe waarde van deze eigenschap.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject maakt gebruik van de standaardlandinstelling van de gebruiker als de standaardwaarde van deze eigenschap.

IAxWinAmbientDispatch::p ut_MessageReflect

De MessageReflect omgevingseigenschap geeft aan of de container berichten weergeeft aan het gehoste besturingselement.

STDMETHOD(put_MessageReflect)(VARIANT_BOOL bMessageReflect);

Parameterwaarden

bMessageReflect
[in] De nieuwe waarde van deze eigenschap.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject gebruikt VARIANT_TRUE als de standaardwaarde van deze eigenschap.

IAxWinAmbientDispatch::p ut_OptionKeyPath

De OptionKeyPath eigenschap geeft het pad naar de registersleutel op naar gebruikersinstellingen.

STDMETHOD(put_OptionKeyPath)(BSTR bstrOptionKeyPath);

Parameterwaarden

bstrOptionKeyPath
[in] De nieuwe waarde van deze eigenschap.

Retourwaarde

Een standaard HRESULT-waarde.

IAxWinAmbientDispatch::p ut_UserMode

De UserMode eigenschap geeft de omgevingsgebruikersmodus van de container op.

STDMETHOD(put_UserMode)(VARIANT_BOOL bUserMode);

Parameterwaarden

bUserMode
[in] De nieuwe waarde van deze eigenschap.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

De implementatie van het ATL-hostobject gebruikt VARIANT_TRUE als de standaardwaarde van deze eigenschap.

IAxWinAmbientDispatchEx::SetAmbientDispatch

Deze methode wordt aangeroepen om de standaardinterface voor omgevingseigenschappen aan te vullen met een door de gebruiker gedefinieerde interface.

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

Parameterwaarden

pDispatch
Aanwijzer naar de nieuwe interface.

Retourwaarde

Retourneert S_OK bij succes of een fout HRESULT bij fout.

Opmerkingen

Wanneer SetAmbientDispatch deze wordt aangeroepen met een aanwijzer naar een nieuwe interface, wordt deze nieuwe interface gebruikt om eigenschappen of methoden aan te roepen die door het gehoste besturingselement worden gevraagd, als deze eigenschappen nog niet worden geleverd door IAxWinAmbientDispatch.

IAxWinHostWindow::AttachControl

Hiermee koppelt u een bestaand besturingselement (en eerder geïnitialiseerd) aan het hostobject met behulp van het venster dat is geïdentificeerd door hWnd.

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

Parameterwaarden

pUnkControl
[in] Een aanwijzer naar de IUnknown interface van het besturingselement dat moet worden gekoppeld aan het hostobject.

hWnd
[in] Een ingang voor het venster dat moet worden gebruikt voor hosting.

Retourwaarde

Een standaard HRESULT-waarde.

IAxWinHostWindow::CreateControl

Hiermee maakt u een besturingselement, initialiseert u het en hostt u dit in het venster dat is geïdentificeerd door hWnd.

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

Parameterwaarden

lpTricsData
[in] Een tekenreeks die het besturingselement identificeert dat moet worden gemaakt. Kan een CLSID zijn (moet de accolades bevatten), ProgID, URL of onbewerkte HTML (voorafgegaan door MSHTML:).

hWnd
[in] Een ingang voor het venster dat moet worden gebruikt voor hosting.

pStream
[in] Een interfaceaanwijzer voor een stroom met initialisatiegegevens voor het besturingselement. Kan NULL zijn.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

Dit venster wordt gesubklasseerd door het hostobject dat deze interface weergeeft, zodat berichten kunnen worden weerspiegeld in het besturingselement en andere containerfuncties werken.

Het aanroepen van deze methode komt overeen met het aanroepen van IAxWinHostWindow::CreateControlEx.

Als u een gelicentieerd ActiveX-besturingselement wilt maken, raadpleegt u IAxWinHostWindowLic::CreateControlLic.

IAxWinHostWindow::CreateControlEx

Hiermee maakt u een ActiveX-besturingselement, initialiseert het en hostt u dit in het opgegeven venster, vergelijkbaar met IAxWinHostWindow::CreateControl.

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

Parameterwaarden

lpTricsData
[in] Een tekenreeks die het besturingselement identificeert dat moet worden gemaakt. Kan een CLSID zijn (moet de accolades bevatten), ProgID, URL of onbewerkte HTML (voorafgegaan door MSHTML:).

hWnd
[in] Een ingang voor het venster dat moet worden gebruikt voor hosting.

pStream
[in] Een interfaceaanwijzer voor een stroom met initialisatiegegevens voor het besturingselement. Kan NULL zijn.

ppUnk
[uit] Het adres van een aanwijzer die de IUnknown interface van het gemaakte besturingselement ontvangt. Kan NULL zijn.

riidAdvise
[in] De interface-id van een uitgaande interface op het ingesloten object. Kan worden IID_NULL.

punkAdvise
[in] Een aanwijzer naar de IUnknown interface van het sink-object dat moet worden verbonden met het verbindingspunt op het ingesloten object dat is opgegeven door iidSink.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

In tegenstelling tot de CreateControl methode kunt CreateControlEx u ook een interfaceaanwijzer ontvangen naar het zojuist gemaakte besturingselement en een gebeurtenissink instellen om gebeurtenissen te ontvangen die door het besturingselement worden geactiveerd.

Als u een gelicentieerd ActiveX-besturingselement wilt maken, raadpleegt u IAxWinHostWindowLic::CreateControlLicEx.

IAxWinHostWindow::QueryControl

Retourneert de opgegeven interfacepointer die wordt geleverd door het gehoste besturingselement.

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

Parameterwaarden

riid
[in] De id van een interface op het besturingselement dat wordt aangevraagd.

ppvObject
[uit] Het adres van een aanwijzer die de opgegeven interface van het gemaakte besturingselement ontvangt.

Retourwaarde

Een standaard HRESULT-waarde.

IAxWinHostWindow::SetExternalDispatch

Hiermee stelt u de externe dispinterface in, die beschikbaar is voor ingesloten besturingselementen via de methode IDocHostUIHandlerDispatch::GetExternal .

STDMETHOD(SetExternalDispatch)(IDispatch* pDisp);

Parameterwaarden

pDisp
[in] Een aanwijzer naar een IDispatch interface.

Retourwaarde

Een standaard HRESULT-waarde.

IAxWinHostWindow::SetExternalUIHandler

Roep deze functie aan om de externe IDocHostUIHandlerDispatch-interface voor het CAxWindow object in te stellen.

STDMETHOD(SetExternalUIHandler)(IDocHostUIHandlerDispatch* pDisp);

Parameterwaarden

pDisp
[in] Een aanwijzer naar een IDocHostUIHandlerDispatch interface.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

Deze functie wordt gebruikt door besturingselementen (zoals het webbrowserbesturingselement) die een query uitvoeren op de site van de host voor de IDocHostUIHandlerDispatch interface.

IAxWinHostWindowLic::CreateControlLic

Hiermee maakt u een gelicentieerd besturingselement, initialiseert u het en hostt u het in het venster dat wordt geïdentificeerd door hWnd.

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

Parameterwaarden

bstrLic
[in] De BSTR die de licentiesleutel voor het besturingselement bevat.

Opmerkingen

Zie IAxWinHostWindow::CreateControl voor een beschrijving van de resterende parameters en retourwaarde.

Het aanroepen van deze methode is gelijk aan het aanroepen van IAxWinHostWindowLic::CreateControlLicEx

Example

Zie ActiveX-besturingselementen hosten met ATL AXHost voor een voorbeeld dat wordt gebruikt IAxWinHostWindowLic::CreateControlLic.

IAxWinHostWindowLic::CreateControlLicEx

Hiermee maakt u een gelicentieerd ActiveX-besturingselement, initialiseert het en hostt het in het opgegeven venster, vergelijkbaar met IAxWinHostWindow::CreateControl.

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

Parameterwaarden

bstrLic
[in] De BSTR die de licentiesleutel voor het besturingselement bevat.

Opmerkingen

Zie IAxWinHostWindow::CreateControlEx voor een beschrijving van de resterende parameters en retourwaarde.

Example

Zie ActiveX-besturingselementen hosten met ATL AXHost voor een voorbeeld dat wordt gebruikt IAxWinHostWindowLic::CreateControlLicEx.

Zie ook

Overzicht van klassen