Klasa IAtlMemMgr
Ta klasa reprezentuje interfejs menedżera pamięci.
Składnia
__interface __declspec(uuid("654F7EF5-CFDF-4df9-A450-6C6A13C622C0")) IAtlMemMgr
Elementy członkowskie
Metody
| Nazwa/nazwisko | opis |
|---|---|
| Przydzielić | Wywołaj tę metodę, aby przydzielić blok pamięci. |
| Bezpłatna | Wywołaj tę metodę, aby zwolnić blok pamięci. |
| GetSize | Wywołaj tę metodę, aby pobrać rozmiar przydzielonego bloku pamięci. |
| Przydziel przydział rzeczywisty | Wywołaj tę metodę, aby ponownie przydzielić blok pamięci. |
Uwagi
Ten interfejs jest implementowany przez CComHeap, CCRTHeap, CLocalHeap, CGlobalHeap lub CWin32Heap.
Uwaga
Funkcje stosu lokalnego i globalnego są wolniejsze niż inne funkcje zarządzania pamięcią i nie udostępniają tak wielu funkcji. W związku z tym nowe aplikacje powinny używać funkcji stert. Są one dostępne w klasie CWin32Heap .
Przykład
// 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;
}
Wymagania
Nagłówek: atlmem.h
IAtlMemMgr::Przydziel
Wywołaj tę metodę, aby przydzielić blok pamięci.
void* Allocate(size_t nBytes) throw();
Parametry
nBajty
Żądana liczba bajtów w nowym bloku pamięci.
Wartość zwracana
Zwraca wskaźnik na początek nowo przydzielonego bloku pamięci.
Uwagi
Wywołaj metodę IAtlMemMgr::Free lub IAtlMemMgr::Reallocate , aby zwolnić pamięć przydzieloną przez tę metodę.
Przykład
Przykład można znaleźć w temacie IAtlMemMgr Overview (Omówienie programu IAtlMemMgr).
IAtlMemMgr::Free
Wywołaj tę metodę, aby zwolnić blok pamięci.
void Free(void* p) throw();
Parametry
p
Wskaźnik do pamięci przydzielonej wcześniej przez tego menedżera pamięci.
Uwagi
Użyj tej metody, aby zwolnić pamięć uzyskaną przez program IAtlMemMgr::Przydziel lub IAtlMemMgr::Reallocate.
Przykład
Przykład można znaleźć w temacie IAtlMemMgr Overview (Omówienie programu IAtlMemMgr).
IAtlMemMgr::GetSize
Wywołaj tę metodę, aby pobrać rozmiar przydzielonego bloku pamięci.
size_t GetSize(void* p) throw();
Parametry
p
Wskaźnik do pamięci przydzielonej wcześniej przez tego menedżera pamięci.
Wartość zwracana
Zwraca rozmiar bloku pamięci w bajtach.
Przykład
Przykład można znaleźć w temacie IAtlMemMgr Overview (Omówienie programu IAtlMemMgr).
IAtlMemMgr::Reallocate
Wywołaj tę metodę, aby ponownie przydzielić pamięć przydzieloną przez tego menedżera pamięci.
void* Reallocate(void* p, size_t nBytes) throw();
Parametry
p
Wskaźnik do pamięci przydzielonej wcześniej przez tego menedżera pamięci.
nBajty
Żądana liczba bajtów w nowym bloku pamięci.
Wartość zwracana
Zwraca wskaźnik na początek nowo przydzielonego bloku pamięci.
Uwagi
Wywołaj metodę IAtlMemMgr::Free lub IAtlMemMgr::Reallocate , aby zwolnić pamięć przydzieloną przez tę metodę.
Koncepcyjnie ta metoda zwalnia istniejącą pamięć i przydziela nowy blok pamięci. W rzeczywistości istniejąca pamięć może zostać rozszerzona lub w inny sposób ponownie użyta.
Przykład
Przykład można znaleźć w temacie IAtlMemMgr Overview (Omówienie programu IAtlMemMgr).
IAxWinAmbientDispatch::get_AllowContextMenu
Właściwość określa, czy hostowana AllowContextMenu kontrolka może wyświetlać własne menu kontekstowe.
STDMETHOD(get_AllowContextMenu)(VARIANT_BOOL* pbAllowContextMenu);
Parametry
pbAllowContextMenu
[out] Adres zmiennej do odbierania bieżącej wartości tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa VARIANT_TRUE jako wartości domyślnej tej właściwości.
IAxWinAmbientDispatch::get_AllowShowUI
Właściwość AllowShowUI określa, czy hostowana kontrolka może wyświetlać własny interfejs użytkownika.
STDMETHOD(get_AllowShowUI)(VARIANT_BOOL* pbAllowShowUI);
Parametry
pbAllowShowUI
[out] Adres zmiennej do odbierania bieżącej wartości tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa VARIANT_FALSE jako wartości domyślnej tej właściwości.
IAxWinAmbientDispatch::get_AllowWindowlessActivation
Właściwość AllowWindowlessActivation określa, czy kontener zezwoli na aktywację bez okien.
STDMETHOD(get_AllowWindowlessActivation)(VARIANT_BOOL* pbAllowWindowless);
Parametry
pbAllowWindowless
[out] Adres zmiennej do odbierania bieżącej wartości tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa VARIANT_TRUE jako wartości domyślnej tej właściwości.
IAxWinAmbientDispatch::get_BackColor
Właściwość BackColor określa kolor tła otoczenia kontenera.
STDMETHOD(get_BackColor)(OLE_COLOR* pclrBackground);
Parametry
pclrBackground
[out] Adres zmiennej do odbierania bieżącej wartości tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa COLOR_BTNFACE lub COLOR_WINDOW jako wartości domyślnej tej właściwości (w zależności od tego, czy element nadrzędny okna hosta jest oknem dialogowym, czy nie).
IAxWinAmbientDispatch::get_DisplayAsDefault
DisplayAsDefault to właściwość otoczenia, która umożliwia kontrolce sprawdzanie, czy jest to domyślna kontrolka.
STDMETHOD(get_DisplayAsDefault)(VARIANT_BOOL* pbDisplayAsDefault);
Parametry
pbDisplayAsDefault
[out] Adres zmiennej do odbierania bieżącej wartości tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa VARIANT_FALSE jako wartości domyślnej tej właściwości.
IAxWinAmbientDispatch::get_DocHostDoubleClickFlags
Właściwość DocHostDoubleClickFlags określa operację, która powinna odbywać się w odpowiedzi na dwukrotne kliknięcie.
STDMETHOD(get_DocHostDoubleClickFlags)(DWORD* pdwDocHostDoubleClickFlags);
Parametry
pdwDocHostDoubleClickFlags
[out] Adres zmiennej do odbierania bieżącej wartości tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa DOCHOSTUIDBLCLK_DEFAULT jako wartości domyślnej tej właściwości.
IAxWinAmbientDispatch::get_DocHostFlags
Właściwość DocHostFlags określa możliwości interfejsu użytkownika obiektu hosta.
STDMETHOD(get_DocHostFlags)(DWORD* pdwDocHostFlags);
Parametry
pdwDocHostFlags
[out] Adres zmiennej do odbierania bieżącej wartości tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa DOCHOSTUIFLAG_NO3DBORDER jako wartości domyślnej tej właściwości.
IAxWinAmbientDispatch::get_Font
Właściwość Font określa czcionkę otoczenia kontenera.
STDMETHOD(get_Font)(IFontDisp** pFont);
Parametry
pFont
[out] Adres wskaźnika interfejsu IFontDisp używanego do odbierania bieżącej wartości tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa domyślnej czcionki graficznego interfejsu użytkownika lub czcionki systemowej jako wartości domyślnej tej właściwości.
IAxWinAmbientDispatch::get_ForeColor
Właściwość ForeColor określa kolor otoczenia pierwszego planu kontenera.
STDMETHOD(get_ForeColor)(OLE_COLOR* pclrForeground);
Parametry
pclrForeground
[out] Adres zmiennej do odbierania bieżącej wartości tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa koloru tekstu okna systemowego jako wartości domyślnej tej właściwości.
IAxWinAmbientDispatch::get_LocaleID
Właściwość LocaleID określa identyfikator ustawień regionalnych otoczenia kontenera.
STDMETHOD(get_LocaleID)(LCID* plcidLocaleID);
Parametry
plcidLocaleID
[out] Adres zmiennej do odbierania bieżącej wartości tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa domyślnych ustawień regionalnych użytkownika jako wartości domyślnej tej właściwości.
Za pomocą tej metody można odnaleźć identyfikator LocalID otoczenia, czyli localeID programu, w którym jest używana kontrolka. Gdy znasz identyfikator LocaleID, możesz wywołać kod, aby załadować transkrypty specyficzne dla ustawień regionalnych, tekst komunikatu o błędzie i tak dalej z pliku zasobu lub biblioteki DLL satelitarnej.
IAxWinAmbientDispatch::get_MessageReflect
Właściwość MessageReflect otoczenia określa, czy kontener będzie odzwierciedlać komunikaty do hostowanej kontrolki.
STDMETHOD(get_MessageReflect)(VARIANT_BOOL* pbMessageReflect);
Parametry
pbMessageReflect
[out] Adres zmiennej do odbierania bieżącej wartości tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa VARIANT_TRUE jako wartości domyślnej tej właściwości.
IAxWinAmbientDispatch::get_OptionKeyPath
Właściwość OptionKeyPath określa ścieżkę klucza rejestru do ustawień użytkownika.
STDMETHOD(get_OptionKeyPath)(BSTR* pbstrOptionKeyPath);
Parametry
pbstrOptionKeyPath
[out] Adres zmiennej do odbierania bieżącej wartości tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
IAxWinAmbientDispatch::get_ShowGrabHandles
Właściwość ShowGrabHandles otoczenia pozwala kontrolce dowiedzieć się, czy powinien rysować się z uchwytami chwytania.
STDMETHOD(get_ShowGrabHandles)(VARIANT_BOOL* pbShowGrabHandles);
Parametry
pbShowGrabHandles
[out] Adres zmiennej do odbierania bieżącej wartości tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL zawsze zwraca VARIANT_FALSE jako wartość tej właściwości.
IAxWinAmbientDispatch::get_ShowHatching
Właściwość ShowHatching otoczenia pozwala kontrolce dowiedzieć się, czy powinien narysować się wykluł.
STDMETHOD(get_ShowHatching)(VARIANT_BOOL* pbShowHatching);
Parametry
pbShowHatching
[out] Adres zmiennej do odbierania bieżącej wartości tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL zawsze zwraca VARIANT_FALSE jako wartość tej właściwości.
IAxWinAmbientDispatch::get_UserMode
Właściwość UserMode określa otoczenia trybu użytkownika kontenera.
STDMETHOD(get_UserMode)(VARIANT_BOOL* pbUserMode);
Parametry
pbUserMode
[out] Adres zmiennej do odbierania bieżącej wartości tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa VARIANT_TRUE jako wartości domyślnej tej właściwości.
IAxWinAmbientDispatch::p ut_AllowContextMenu
Właściwość określa, czy hostowana AllowContextMenu kontrolka może wyświetlać własne menu kontekstowe.
STDMETHOD(put_AllowContextMenu)(VARIANT_BOOL bAllowContextMenu);
Parametry
bAllowContextMenu
[in] Nowa wartość tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa VARIANT_TRUE jako wartości domyślnej tej właściwości.
IAxWinAmbientDispatch::p ut_AllowShowUI
Właściwość AllowShowUI określa, czy hostowana kontrolka może wyświetlać własny interfejs użytkownika.
STDMETHOD(put_AllowShowUI)(VARIANT_BOOL bAllowShowUI);
Parametry
bAllowShowUI
[in] Nowa wartość tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa VARIANT_FALSE jako wartości domyślnej tej właściwości.
IAxWinAmbientDispatch::p ut_AllowWindowlessActivation
Właściwość AllowWindowlessActivation określa, czy kontener zezwoli na aktywację bez okien.
STDMETHOD(put_AllowWindowlessActivation)(VARIANT_BOOL bAllowWindowless);
Parametry
bAllowWindowless
[in] Nowa wartość tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa VARIANT_TRUE jako wartości domyślnej tej właściwości.
IAxWinAmbientDispatch::p ut_BackColor
Właściwość BackColor określa kolor tła otoczenia kontenera.
STDMETHOD(put_BackColor)(OLE_COLOR clrBackground);
Parametry
clrBackground
[in] Nowa wartość tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa COLOR_BTNFACE lub COLOR_WINDOW jako wartości domyślnej tej właściwości (w zależności od tego, czy element nadrzędny okna hosta jest oknem dialogowym, czy nie).
IAxWinAmbientDispatch::p ut_DisplayAsDefault
DisplayAsDefault to właściwość otoczenia, która umożliwia kontrolce sprawdzanie, czy jest to domyślna kontrolka.
STDMETHOD(put_DisplayAsDefault)(VARIANT_BOOL bDisplayAsDefault);
Parametry
bDisplayAsDefault
[in] Nowa wartość tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa VARIANT_FALSE jako wartości domyślnej tej właściwości.
IAxWinAmbientDispatch::p ut_DocHostDoubleClickFlags
Właściwość DocHostDoubleClickFlags określa operację, która powinna odbywać się w odpowiedzi na dwukrotne kliknięcie.
STDMETHOD(put_DocHostDoubleClickFlags)(DWORD dwDocHostDoubleClickFlags);
Parametry
dwDocHostDoubleClickFlags
[in] Nowa wartość tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa DOCHOSTUIDBLCLK_DEFAULT jako wartości domyślnej tej właściwości.
IAxWinAmbientDispatch::p ut_DocHostFlags
Właściwość DocHostFlags określa możliwości interfejsu użytkownika obiektu hosta.
STDMETHOD(put_DocHostFlags)(DWORD dwDocHostFlags);
Parametry
dwDocHostFlags
[in] Nowa wartość tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa DOCHOSTUIFLAG_NO3DBORDER jako wartości domyślnej tej właściwości.
IAxWinAmbientDispatch::p ut_Font
Właściwość Font określa czcionkę otoczenia kontenera.
STDMETHOD(put_Font)(IFontDisp* pFont);
Parametry
pFont
[in] Nowa wartość tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa domyślnej czcionki graficznego interfejsu użytkownika lub czcionki systemowej jako wartości domyślnej tej właściwości.
IAxWinAmbientDispatch::p ut_ForeColor
Właściwość ForeColor określa kolor otoczenia pierwszego planu kontenera.
STDMETHOD(put_ForeColor)(OLE_COLOR clrForeground);
Parametry
clrForeground
[in] Nowa wartość tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa koloru tekstu okna systemowego jako wartości domyślnej tej właściwości.
IAxWinAmbientDispatch::p ut_LocaleID
Właściwość LocaleID określa identyfikator ustawień regionalnych otoczenia kontenera.
STDMETHOD(put_LocaleID)(LCID lcidLocaleID);
Parametry
lcidLocaleID
[in] Nowa wartość tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa domyślnych ustawień regionalnych użytkownika jako wartości domyślnej tej właściwości.
IAxWinAmbientDispatch::p ut_MessageReflect
Właściwość MessageReflect otoczenia określa, czy kontener będzie odzwierciedlać komunikaty do hostowanej kontrolki.
STDMETHOD(put_MessageReflect)(VARIANT_BOOL bMessageReflect);
Parametry
bMessageReflect
[in] Nowa wartość tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa VARIANT_TRUE jako wartości domyślnej tej właściwości.
IAxWinAmbientDispatch::p ut_OptionKeyPath
Właściwość OptionKeyPath określa ścieżkę klucza rejestru do ustawień użytkownika.
STDMETHOD(put_OptionKeyPath)(BSTR bstrOptionKeyPath);
Parametry
bstrOptionKeyPath
[in] Nowa wartość tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
IAxWinAmbientDispatch::p ut_UserMode
Właściwość UserMode określa otoczenia trybu użytkownika kontenera.
STDMETHOD(put_UserMode)(VARIANT_BOOL bUserMode);
Parametry
bUserMode
[in] Nowa wartość tej właściwości.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Implementacja obiektu hosta ATL używa VARIANT_TRUE jako wartości domyślnej tej właściwości.
IAxWinAmbientDispatchEx::SetAmbientDispatch
Ta metoda jest wywoływana w celu uzupełnienia domyślnego interfejsu właściwości otoczenia za pomocą interfejsu zdefiniowanego przez użytkownika.
virtual HRESULT STDMETHODCALLTYPE SetAmbientDispatch(IDispatch* pDispatch) = 0;
Parametry
pDispatch
Wskaźnik do nowego interfejsu.
Wartość zwracana
Zwraca S_OK powodzenia lub błąd HRESULT w przypadku niepowodzenia.
Uwagi
Gdy SetAmbientDispatch jest wywoływany za pomocą wskaźnika do nowego interfejsu, ten nowy interfejs będzie używany do wywoływania wszelkich właściwości lub metod wywoływanych przez hostowaną kontrolkę — jeśli te właściwości nie są jeszcze udostępniane przez interfejs IAxWinAmbientDispatch.
IAxWinHostWindow::AttachControl
Dołącza istniejącą (i wcześniej zainicjowaną) kontrolkę do obiektu hosta przy użyciu okna zidentyfikowanego przez hWnd.
STDMETHOD(AttachControl)(IUnknown* pUnkControl, HWND hWnd);
Parametry
pUnkControl
[in] Wskaźnik do IUnknown interfejsu kontrolki, która ma być dołączona do obiektu hosta.
hWnd
[in] Uchwyt do okna, który ma być używany do hostowania.
Wartość zwracana
Standardowa wartość HRESULT.
IAxWinHostWindow::CreateControl
Tworzy kontrolkę, inicjuje ją i hostuje w oknie zidentyfikowanym przez hWnd.
STDMETHOD(CreateControl)(
LPCOLESTR lpTricsData,
HWND hWnd,
IStream* pStream);
Parametry
lpTricsData
[in] Ciąg identyfikujący kontrolkę do utworzenia. Może to być identyfikator CLSID (musi zawierać nawiasy klamrowe), ProgID, URL lub nieprzetworzony kod HTML (poprzedzony ciągiem MSHTML:).
hWnd
[in] Uchwyt do okna, który ma być używany do hostowania.
pStream
[in] Wskaźnik interfejsu dla strumienia zawierającego dane inicjowania dla kontrolki. Może mieć wartość NULL.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
To okno będzie podklasowane przez obiekt hosta uwidaczniając ten interfejs, aby komunikaty mogły być odzwierciedlane w kontrolce, a inne funkcje kontenera będą działać.
Wywołanie tej metody jest równoważne wywołaniu metody IAxWinHostWindow::CreateControlEx.
Aby utworzyć licencjonowany formant ActiveX, zobacz IAxWinHostWindowLic::CreateControlLic.
IAxWinHostWindow::CreateControlEx
Tworzy kontrolkę ActiveX, inicjuje ją i hostuje w określonym oknie, podobnie jak IAxWinHostWindow::CreateControl.
STDMETHOD(CreateControlEx)(
LPCOLESTR lpszTricsData,
HWND hWnd,
IStream* pStream,
IUnknown** ppUnk,
REFIID riidAdvise,
IUnknown* punkAdvise);
Parametry
lpTricsData
[in] Ciąg identyfikujący kontrolkę do utworzenia. Może to być identyfikator CLSID (musi zawierać nawiasy klamrowe), ProgID, URL lub nieprzetworzony kod HTML (poprzedzony plikiem MSHTML:).
hWnd
[in] Uchwyt do okna, który ma być używany do hostowania.
pStream
[in] Wskaźnik interfejsu dla strumienia zawierającego dane inicjowania dla kontrolki. Może mieć wartość NULL.
ppUnk
[out] Adres wskaźnika, który otrzyma IUnknown interfejs utworzonej kontrolki. Może mieć wartość NULL.
riidAdvise
[in] Identyfikator interfejsu interfejsu wychodzącego w zawartym obiekcie. Może być IID_NULL.
punkAdvise
[in] Wskaźnik do IUnknown interfejsu obiektu ujścia, który ma być połączony z punktem połączenia dla zawartego obiektu określonego przez iidSink.
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
CreateControl W przeciwieństwie do metody, CreateControlEx umożliwia również odbieranie wskaźnika interfejsu do nowo utworzonej kontrolki i skonfigurowanie ujścia zdarzeń w celu odbierania zdarzeń wyzwalanych przez kontrolkę.
Aby utworzyć licencjonowany formant ActiveX, zobacz IAxWinHostWindowLic::CreateControlLicEx.
IAxWinHostWindow::QueryControl
Zwraca określony wskaźnik interfejsu dostarczony przez hostowaną kontrolkę.
STDMETHOD(QueryControl)(REFIID riid, void** ppvObject);
Parametry
riid
[in] Identyfikator interfejsu żądanego formantu.
ppvObject
[out] Adres wskaźnika, który otrzyma określony interfejs utworzonej kontrolki.
Wartość zwracana
Standardowa wartość HRESULT.
IAxWinHostWindow::SetExternalDispatch
Ustawia zewnętrzny dispinterface, który jest dostępny dla zawartych kontrolek za pośrednictwem metody IDocHostUIHandlerDispatch::GetExternal .
STDMETHOD(SetExternalDispatch)(IDispatch* pDisp);
Parametry
pDisp
[in] Wskaźnik do interfejsu IDispatch .
Wartość zwracana
Standardowa wartość HRESULT.
IAxWinHostWindow::SetExternalUIHandler
Wywołaj tę funkcję, aby ustawić zewnętrzny interfejs IDocHostUIHandlerDispatch dla CAxWindow obiektu.
STDMETHOD(SetExternalUIHandler)(IDocHostUIHandlerDispatch* pDisp);
Parametry
pDisp
[in] Wskaźnik do interfejsu IDocHostUIHandlerDispatch .
Wartość zwracana
Standardowa wartość HRESULT.
Uwagi
Ta funkcja jest używana przez kontrolki (takie jak kontrolka przeglądarki sieci Web), które wysyłają zapytanie do witryny hosta dla interfejsu IDocHostUIHandlerDispatch .
IAxWinHostWindowLic::CreateControlLic
Tworzy licencjonowany formant, inicjuje go i hostuje go w oknie zidentyfikowanym przez hWndprogram .
STDMETHOD(CreateControlLic)(
LPCOLESTR lpTricsData,
HWND hWnd,
IStream* pStream,
BSTR bstrLic);
Parametry
bstrLic
[in] Ciąg BSTR zawierający klucz licencji dla kontrolki.
Uwagi
Zobacz IAxWinHostWindow::CreateControl , aby uzyskać opis pozostałych parametrów i zwracanej wartości.
Wywoływanie tej metody jest równoważne wywołaniu metody IAxWinHostWindowLic::CreateControlLicEx
Przykład
Zobacz Hostowanie kontrolek ActiveX przy użyciu atL AXHost , aby zapoznać się z przykładem korzystającym z elementu IAxWinHostWindowLic::CreateControlLic.
IAxWinHostWindowLic::CreateControlLicEx
Tworzy licencjonowany formant ActiveX, inicjuje go i hostuje go w określonym oknie, podobnie jak IAxWinHostWindow::CreateControl.
STDMETHOD(CreateControlLicEx)(
LPCOLESTR lpszTricsData,
HWND hWnd,
IStream* pStream,
IUnknown** ppUnk,
REFIID riidAdvise,
IUnknown* punkAdvise,
BSTR bstrLic);
Parametry
bstrLic
[in] Ciąg BSTR zawierający klucz licencji dla kontrolki.
Uwagi
Zobacz IAxWinHostWindow::CreateControlEx , aby uzyskać opis pozostałych parametrów i zwracanej wartości.
Przykład
Zobacz Hostowanie kontrolek ActiveX przy użyciu atL AXHost , aby zapoznać się z przykładem korzystającym z elementu IAxWinHostWindowLic::CreateControlLicEx.