Classe IAtlMemMgr

Questa classe rappresenta l'interfaccia di una gestione della memoria.

Sintassi

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

Membri

Metodi

Nome	Descrizione
Allocare	Chiamare questo metodo per allocare un blocco di memoria.
Gratuito	Chiamare questo metodo per liberare un blocco di memoria.
GetSize	Chiamare questo metodo per recuperare le dimensioni di un blocco di memoria allocato.
Ridistribuire	Chiamare questo metodo per riallocare un blocco di memoria.

Osservazioni:

Questa interfaccia viene implementata da CComHeap, CCRTHeap, CLocalHeap, CGlobalHeap o CWin32Heap.

Nota

Le funzioni heap locali e globali sono più lente rispetto ad altre funzioni di gestione della memoria e non forniscono tutte le funzionalità. Pertanto, le nuove applicazioni devono usare le funzioni heap. Questi sono disponibili nella classe CWin32Heap .

Esempio

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

Requisiti

Intestazione: atlmem.h

IAtlMemMgr::Allocate

Chiamare questo metodo per allocare un blocco di memoria.

void* Allocate(size_t nBytes) throw();

Parametri

nBytes
Numero di byte necessari nel nuovo blocco di memoria.

Valore restituito

Restituisce un puntatore all'inizio del blocco di memoria allocata.

Osservazioni:

Chiama IAtlMemMgr::Free o IAtlMemMgr::Reallocate per liberare la memoria allocata da questo metodo.

Esempio

Per un esempio, vedere Panoramica di IAtlMemMgr.

IAtlMemMgr::Free

Chiamare questo metodo per liberare un blocco di memoria.

void Free(void* p) throw();

Parametri

p
Puntatore alla memoria precedentemente allocata dal gestore di memoria.

Osservazioni:

Usare questo metodo per liberare memoria ottenuta da IAtlMemMgr::Allocate o IAtlMemMgr::Reallocate.

Esempio

Per un esempio, vedere Panoramica di IAtlMemMgr.

IAtlMemMgr::GetSize

Chiamare questo metodo per recuperare le dimensioni di un blocco di memoria allocato.

size_t GetSize(void* p) throw();

Parametri

p
Puntatore alla memoria precedentemente allocata dal gestore di memoria.

Valore restituito

Restituisce le dimensioni del blocco di memoria in byte.

Esempio

Per un esempio, vedere Panoramica di IAtlMemMgr.

IAtlMemMgr::Reallocate

Chiamare questo metodo per riallocare la memoria allocata da questo gestore di memoria.

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

Parametri

p
Puntatore alla memoria precedentemente allocata dal gestore di memoria.

nBytes
Numero di byte necessari nel nuovo blocco di memoria.

Valore restituito

Restituisce un puntatore all'inizio del blocco di memoria allocata.

Osservazioni:

Chiama IAtlMemMgr::Free o IAtlMemMgr::Reallocate per liberare la memoria allocata da questo metodo.

Concettualmente questo metodo libera la memoria esistente e alloca un nuovo blocco di memoria. In realtà, la memoria esistente può essere estesa o riutilizzata in altro modo.

Esempio

Per un esempio, vedere Panoramica di IAtlMemMgr.

IAxWinAmbientDispatch::get_AllowContextMenu

La AllowContextMenu proprietà specifica se il controllo ospitato può visualizzare il proprio menu di scelta rapida.

STDMETHOD(get_AllowContextMenu)(VARIANT_BOOL* pbAllowContextMenu);

Parametri

pbAllowContextMenu
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa VARIANT_TRUE come valore predefinito di questa proprietà.

IAxWinAmbientDispatch::get_AllowShowUI

La AllowShowUI proprietà specifica se il controllo ospitato può visualizzare la propria interfaccia utente.

STDMETHOD(get_AllowShowUI)(VARIANT_BOOL* pbAllowShowUI);

Parametri

pbAllowShowUI
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa VARIANT_FALedizione Standard come valore predefinito di questa proprietà.

IAxWinAmbientDispatch::get_AllowWindowlessActivation

La AllowWindowlessActivation proprietà specifica se il contenitore consentirà l'attivazione senza finestra.

STDMETHOD(get_AllowWindowlessActivation)(VARIANT_BOOL* pbAllowWindowless);

Parametri

pbAllowWindowless
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa VARIANT_TRUE come valore predefinito di questa proprietà.

IAxWinAmbientDispatch::get_BackColor

La BackColor proprietà specifica il colore di sfondo ambientale del contenitore.

STDMETHOD(get_BackColor)(OLE_COLOR* pclrBackground);

Parametri

pclrBackground
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa COLOR_BTNFACE o COLOR_WINDOW come valore predefinito di questa proprietà , a seconda che l'elemento padre della finestra host sia o meno un dialogo.

IAxWinAmbientDispatch::get_DisplayAsDefault

DisplayAsDefault è una proprietà di ambiente che consente a un controllo di verificare se è il controllo predefinito.

STDMETHOD(get_DisplayAsDefault)(VARIANT_BOOL* pbDisplayAsDefault);

Parametri

pbDisplayAsDefault
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa VARIANT_FALedizione Standard come valore predefinito di questa proprietà.

IAxWinAmbientDispatch::get_DocHostDoubleClickFlags

La DocHostDoubleClickFlags proprietà specifica l'operazione che deve essere eseguita in risposta a un doppio clic.

STDMETHOD(get_DocHostDoubleClickFlags)(DWORD* pdwDocHostDoubleClickFlags);

Parametri

pdwDocHostDoubleClickFlags
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa DOCHOSTUIDBLCLK_DEFAULT come valore predefinito di questa proprietà.

IAxWinAmbientDispatch::get_DocHostFlags

La DocHostFlags proprietà specifica le funzionalità dell'interfaccia utente dell'oggetto host.

STDMETHOD(get_DocHostFlags)(DWORD* pdwDocHostFlags);

Parametri

pdwDocHostFlags
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa DOCHOSTUIFLAG_NO3DBORDER come valore predefinito di questa proprietà.

IAxWinAmbientDispatch::get_Font

La Font proprietà specifica il tipo di carattere di ambiente del contenitore.

STDMETHOD(get_Font)(IFontDisp** pFont);

Parametri

pFont
[out] Indirizzo di un IFontDisp puntatore di interfaccia utilizzato per ricevere il valore corrente di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa il tipo di carattere GUI predefinito o il tipo di carattere di sistema come valore predefinito di questa proprietà.

IAxWinAmbientDispatch::get_ForeColor

La ForeColor proprietà specifica il colore di primo piano di ambiente del contenitore.

STDMETHOD(get_ForeColor)(OLE_COLOR* pclrForeground);

Parametri

pclrForeground
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa il colore del testo della finestra di sistema come valore predefinito di questa proprietà.

IAxWinAmbientDispatch::get_LocaleID

La LocaleID proprietà specifica l'ID delle impostazioni locali di ambiente del contenitore.

STDMETHOD(get_LocaleID)(LCID* plcidLocaleID);

Parametri

plcidLocaleID
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa le impostazioni locali predefinite dell'utente come valore predefinito di questa proprietà.

Con questo metodo è possibile individuare l'ID locale di ambiente, ovvero l'ID locale del programma in cui viene usato il controllo. Una volta che si conosce l'ID locale, è possibile chiamare il codice per caricare didascalia specifiche delle impostazioni locali, testo del messaggio di errore e così via da un file di risorse o una DLL satellite.

IAxWinAmbientDispatch::get_MessageReflect

La MessageReflect proprietà ambient specifica se il contenitore rifletterà i messaggi al controllo ospitato.

STDMETHOD(get_MessageReflect)(VARIANT_BOOL* pbMessageReflect);

Parametri

pbMessageReflect
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa VARIANT_TRUE come valore predefinito di questa proprietà.

IAxWinAmbientDispatch::get_OptionKeyPath

La OptionKeyPath proprietà specifica il percorso della chiave del Registro di sistema per le impostazioni utente.

STDMETHOD(get_OptionKeyPath)(BSTR* pbstrOptionKeyPath);

Parametri

pbstrOptionKeyPath
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.

Valore restituito

Valore HRESULT standard.

IAxWinAmbientDispatch::get_ShowGrabHandles

La ShowGrabHandles proprietà di ambiente consente al controllo di scoprire se deve disegnare se stessa con handle di afferramento.

STDMETHOD(get_ShowGrabHandles)(VARIANT_BOOL* pbShowGrabHandles);

Parametri

pbShowGrabHandles
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL restituisce sempre VARIANT_FALedizione Standard come valore di questa proprietà.

IAxWinAmbientDispatch::get_ShowHatching

La ShowHatching proprietà di ambiente consente al controllo di scoprire se deve disegnare se stesso tratteggio.

STDMETHOD(get_ShowHatching)(VARIANT_BOOL* pbShowHatching);

Parametri

pbShowHatching
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL restituisce sempre VARIANT_FALedizione Standard come valore di questa proprietà.

IAxWinAmbientDispatch::get_UserMode

La UserMode proprietà specifica la modalità utente di ambiente del contenitore.

STDMETHOD(get_UserMode)(VARIANT_BOOL* pbUserMode);

Parametri

pbUserMode
[out] Indirizzo di una variabile per ricevere il valore corrente di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa VARIANT_TRUE come valore predefinito di questa proprietà.

IAxWinAmbientDispatch::p ut_AllowContextMenu

La AllowContextMenu proprietà specifica se il controllo ospitato può visualizzare il proprio menu di scelta rapida.

STDMETHOD(put_AllowContextMenu)(VARIANT_BOOL bAllowContextMenu);

Parametri

bAllowContextMenu
[in] Nuovo valore di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa VARIANT_TRUE come valore predefinito di questa proprietà.

IAxWinAmbientDispatch::p ut_AllowShowUI

La AllowShowUI proprietà specifica se il controllo ospitato può visualizzare la propria interfaccia utente.

STDMETHOD(put_AllowShowUI)(VARIANT_BOOL bAllowShowUI);

Parametri

bAllowShowUI
[in] Nuovo valore di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa VARIANT_FALedizione Standard come valore predefinito di questa proprietà.

IAxWinAmbientDispatch::p ut_AllowWindowlessActivation

La AllowWindowlessActivation proprietà specifica se il contenitore consentirà l'attivazione senza finestra.

STDMETHOD(put_AllowWindowlessActivation)(VARIANT_BOOL bAllowWindowless);

Parametri

bAllowWindowless
[in] Nuovo valore di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa VARIANT_TRUE come valore predefinito di questa proprietà.

IAxWinAmbientDispatch::p ut_BackColor

La BackColor proprietà specifica il colore di sfondo ambientale del contenitore.

STDMETHOD(put_BackColor)(OLE_COLOR clrBackground);

Parametri

clrBackground
[in] Nuovo valore di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa COLOR_BTNFACE o COLOR_WINDOW come valore predefinito di questa proprietà , a seconda che l'elemento padre della finestra host sia o meno un dialogo.

IAxWinAmbientDispatch::p ut_DisplayAsDefault

DisplayAsDefault è una proprietà di ambiente che consente a un controllo di verificare se è il controllo predefinito.

STDMETHOD(put_DisplayAsDefault)(VARIANT_BOOL bDisplayAsDefault);

Parametri

bDisplayAsDefault
[in] Nuovo valore di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa VARIANT_FALedizione Standard come valore predefinito di questa proprietà.

IAxWinAmbientDispatch::p ut_DocHostDoubleClickFlags

La DocHostDoubleClickFlags proprietà specifica l'operazione che deve essere eseguita in risposta a un doppio clic.

STDMETHOD(put_DocHostDoubleClickFlags)(DWORD dwDocHostDoubleClickFlags);

Parametri

dwDocHostDoubleClickFlags
[in] Nuovo valore di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa DOCHOSTUIDBLCLK_DEFAULT come valore predefinito di questa proprietà.

IAxWinAmbientDispatch::p ut_DocHostFlags

La DocHostFlags proprietà specifica le funzionalità dell'interfaccia utente dell'oggetto host.

STDMETHOD(put_DocHostFlags)(DWORD dwDocHostFlags);

Parametri

dwDocHostFlags
[in] Nuovo valore di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa DOCHOSTUIFLAG_NO3DBORDER come valore predefinito di questa proprietà.

IAxWinAmbientDispatch::p ut_Font

La Font proprietà specifica il tipo di carattere di ambiente del contenitore.

STDMETHOD(put_Font)(IFontDisp* pFont);

Parametri

pFont
[in] Nuovo valore di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa il tipo di carattere GUI predefinito o il tipo di carattere di sistema come valore predefinito di questa proprietà.

IAxWinAmbientDispatch::p ut_ForeColor

La ForeColor proprietà specifica il colore di primo piano di ambiente del contenitore.

STDMETHOD(put_ForeColor)(OLE_COLOR clrForeground);

Parametri

clrForeground
[in] Nuovo valore di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa il colore del testo della finestra di sistema come valore predefinito di questa proprietà.

IAxWinAmbientDispatch::p ut_LocaleID

La LocaleID proprietà specifica l'ID delle impostazioni locali di ambiente del contenitore.

STDMETHOD(put_LocaleID)(LCID lcidLocaleID);

Parametri

lcidLocaleID
[in] Nuovo valore di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa le impostazioni locali predefinite dell'utente come valore predefinito di questa proprietà.

IAxWinAmbientDispatch::p ut_MessageReflect

La MessageReflect proprietà ambient specifica se il contenitore rifletterà i messaggi al controllo ospitato.

STDMETHOD(put_MessageReflect)(VARIANT_BOOL bMessageReflect);

Parametri

bMessageReflect
[in] Nuovo valore di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa VARIANT_TRUE come valore predefinito di questa proprietà.

IAxWinAmbientDispatch::p ut_OptionKeyPath

La OptionKeyPath proprietà specifica il percorso della chiave del Registro di sistema per le impostazioni utente.

STDMETHOD(put_OptionKeyPath)(BSTR bstrOptionKeyPath);

Parametri

bstrOptionKeyPath
[in] Nuovo valore di questa proprietà.

Valore restituito

Valore HRESULT standard.

IAxWinAmbientDispatch::p ut_UserMode

La UserMode proprietà specifica la modalità utente di ambiente del contenitore.

STDMETHOD(put_UserMode)(VARIANT_BOOL bUserMode);

Parametri

bUserMode
[in] Nuovo valore di questa proprietà.

Valore restituito

Valore HRESULT standard.

Osservazioni:

L'implementazione dell'oggetto host ATL usa VARIANT_TRUE come valore predefinito di questa proprietà.

IAxWinAmbientDispatchEx::SetAmbientDispatch

Questo metodo viene chiamato per integrare l'interfaccia predefinita della proprietà di ambiente con un'interfaccia definita dall'utente.

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

Parametri

pDispatch
Puntatore alla nuova interfaccia.

Valore restituito

Restituisce S_OK in caso di esito positivo o errore HRESULT in caso di errore.

Osservazioni:

Quando SetAmbientDispatch viene chiamato con un puntatore a una nuova interfaccia, questa nuova interfaccia verrà usata per richiamare eventuali proprietà o metodi richiesti dal controllo ospitato, se tali proprietà non sono già fornite da IAxWinAmbientDispatch.

IAxWinHostWindow::AttachControl

Collega un controllo esistente (e inizializzato in precedenza) all'oggetto host usando la finestra identificata da hWnd.

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

Parametri

pUnkControl
[in] Puntatore all'interfaccia IUnknown del controllo da associare all'oggetto host.

hWnd
[in] Handle per la finestra da usare per l'hosting.

Valore restituito

Valore HRESULT standard.

IAxWinHostWindow::CreateControl

Crea un controllo, lo inizializza e lo ospita nella finestra identificata da hWnd.

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

Parametri

lpTricsData
[in] Stringa che identifica il controllo da creare. Può essere un CLSID (deve includere le parentesi graffe), ProgID, URL o HTML non elaborato (preceduto da MSHTML:).

hWnd
[in] Handle per la finestra da usare per l'hosting.

pStream
[in] Puntatore di interfaccia per un flusso contenente i dati di inizializzazione per il controllo. Può essere NULL.

Valore restituito

Valore HRESULT standard.

Osservazioni:

Questa finestra verrà sottoclassata dall'oggetto host che espone questa interfaccia in modo che i messaggi possano essere riflessi nel controllo e che funzionino altre funzionalità del contenitore.

La chiamata a questo metodo equivale a chiamare IAxWinHostWindow::CreateControlEx.

Per creare un controllo ActiveX concesso in licenza, vedere IAxWinHostWindowLic::CreateControlLic.

IAxWinHostWindow::CreateControlEx

Crea un controllo ActiveX, lo inizializza e lo ospita nella finestra specificata, simile a IAxWinHostWindow::CreateControl.

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

Parametri

lpTricsData
[in] Stringa che identifica il controllo da creare. Può essere un CLSID (deve includere le parentesi graffe), ProgID, URL o HTML non elaborato (preceduto da MSHTML:).

hWnd
[in] Handle per la finestra da usare per l'hosting.

pStream
[in] Puntatore di interfaccia per un flusso contenente i dati di inizializzazione per il controllo. Può essere NULL.

ppUnk
[out] Indirizzo di un puntatore che riceverà l'interfaccia IUnknown del controllo creato. Può essere NULL.

riidAdvise
[in] Identificatore dell'interfaccia di un'interfaccia in uscita nell'oggetto contenuto. Può essere IID_NULL.

punkAdvise
[in] Puntatore all'interfaccia dell'oggetto IUnknown sink da connettere al punto di connessione nell'oggetto contenuto specificato da iidSink.

Valore restituito

Valore HRESULT standard.

Osservazioni:

A differenza del CreateControl metodo , CreateControlEx consente anche di ricevere un puntatore di interfaccia al controllo appena creato e di configurare un sink di eventi per ricevere gli eventi generati dal controllo .

Per creare un controllo ActiveX concesso in licenza, vedere IAxWinHostWindowLic::CreateControlLicEx.

IAxWinHostWindow::QueryControl

Restituisce il puntatore all'interfaccia specificato fornito dal controllo ospitato.

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

Parametri

riid
[in] ID di un'interfaccia sul controllo richiesto.

ppvObject
[out] Indirizzo di un puntatore che riceverà l'interfaccia specificata del controllo creato.

Valore restituito

Valore HRESULT standard.

IAxWinHostWindow::SetExternalDispatch

Imposta la dispinterface esterna, disponibile per i controlli contenuti tramite il metodo IDocHostUIHandlerDispatch::GetExternal .

STDMETHOD(SetExternalDispatch)(IDispatch* pDisp);

Parametri

pDisp
[in] Puntatore a un'interfaccia IDispatch .

Valore restituito

Valore HRESULT standard.

IAxWinHostWindow::SetExternalUIHandler

Chiamare questa funzione per impostare l'interfaccia IDocHostUIHandlerDispatch esterna per l'oggettoCAxWindow.

STDMETHOD(SetExternalUIHandler)(IDocHostUIHandlerDispatch* pDisp);

Parametri

pDisp
[in] Puntatore a un'interfaccia IDocHostUIHandlerDispatch .

Valore restituito

Valore HRESULT standard.

Osservazioni:

Questa funzione viene usata dai controlli (ad esempio il controllo Web browser) che eseguono query sul sito dell'host per l'interfaccia IDocHostUIHandlerDispatch .

IAxWinHostWindowLic::CreateControlLic

Crea un controllo con licenza, lo inizializza e lo ospita nella finestra identificata da hWnd.

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

Parametri

bstrLic
[in] BSTR che contiene il codice di licenza per il controllo .

Osservazioni:

Per una descrizione dei parametri rimanenti e del valore restituito, vedere IAxWinHostWindow::CreateControl .

La chiamata a questo metodo equivale a chiamare IAxWinHostWindowLic::CreateControlLicEx

Esempio

Per un esempio che usa , vedere Hosting di controlli ActiveX tramite ATL AXHost.IAxWinHostWindowLic::CreateControlLic

IAxWinHostWindowLic::CreateControlLicEx

Crea un controllo ActiveX concesso in licenza, lo inizializza e lo ospita nella finestra specificata, simile a IAxWinHostWindow::CreateControl.

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

Parametri

bstrLic
[in] BSTR che contiene il codice di licenza per il controllo .

Osservazioni:

Per una descrizione dei parametri rimanenti e del valore restituito, vedere IAxWinHostWindow::CreateControlEx .

Esempio

Per un esempio che usa , vedere Hosting di controlli ActiveX tramite ATL AXHost.IAxWinHostWindowLic::CreateControlLicEx

Vedi anche

Cenni preliminari sulla classe