Udostępnij za pośrednictwem


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.

Zobacz też

Omówienie klasy