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 |
|---|---|
| Stanziare | 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_FALSE 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_FALSE 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 didascalie specifiche delle impostazioni locali, testo del messaggio di errore e così via da un file di risorse o da 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_FALSE 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_FALSE 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_FALSE 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_FALSE 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