IAtlMemMgr クラス

このクラスは、メモリ マネージャーへのインターフェイスを表します。

構文

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

メンバー

メソッド

Name	説明
Allocate	メモリ ブロックを割り当てるには、このメソッドを呼び出します。
Free	メモリ ブロックを解放するには、このメソッドを呼び出します。
GetSize	割り当てられたメモリ ブロックのサイズを取得するには、このメソッドを呼び出します。
Reallocate	メモリ ブロックを再割り当てするには、このメソッドを呼び出します。

解説

このインターフェイスは、CComHeap、CCRTHeap、CLocalHeap、CGlobalHeap、または CWin32Heap によって実装されます。

Note

ローカルおよびグローバル ヒープ関数は、他のメモリ管理機能よりも低速で、多くの機能を提供しません。 そのため、新しいアプリケーションではヒープ関数を使用する必要があります。 CWin32Heap クラスで使用可能です。

例

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

要件

ヘッダー: atlmem.h

IAtlMemMgr::Allocate

メモリ ブロックを割り当てるには、このメソッドを呼び出します。

void* Allocate(size_t nBytes) throw();

パラメーター

nBytes
新しいメモリ ブロック内の要求されたバイト数。

戻り値

新しく割り当てられたメモリ ブロックの先頭へのポインターを返します。

解説

このメソッドによって割り当てられたメモリを解放するには、IAtlMemMgr::Free または IAtlMemMgr::Reallocate を呼び出します。

例

例については、IAtlMemMgr の概要に関するページを参照してください。

IAtlMemMgr::Free

メモリ ブロックを解放するには、このメソッドを呼び出します。

void Free(void* p) throw();

パラメーター

P
このメモリ マネージャーによって以前に割り当てられたメモリへのポインター。

解説

IAtlMemMgr::Allocate または IAtlMemMgr::Reallocate によって取得されたメモリを解放するには、このメソッドを使用します。

例

例については、IAtlMemMgr の概要に関するページを参照してください。

IAtlMemMgr::GetSize

割り当てられたメモリ ブロックのサイズを取得するには、このメソッドを呼び出します。

size_t GetSize(void* p) throw();

パラメーター

P
このメモリ マネージャーによって以前に割り当てられたメモリへのポインター。

戻り値

メモリ ブロックのサイズ (バイト単位) が返されます。

例

例については、IAtlMemMgr の概要に関するページを参照してください。

IAtlMemMgr::Reallocate

このメソッドを呼び出し、このメモリ マネージャーによって割り当てられたメモリの再割り当てを行います。

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

パラメーター

P
このメモリ マネージャーによって以前に割り当てられたメモリへのポインター。

nBytes
新しいメモリ ブロック内の要求されたバイト数。

戻り値

新しく割り当てられたメモリ ブロックの先頭へのポインターを返します。

解説

このメソッドによって割り当てられたメモリを解放するには、IAtlMemMgr::Free または IAtlMemMgr::Reallocate を呼び出します。

概念的には、このメソッドは既存のメモリを解放し、新しいメモリ ブロックを割り当てます。 実際には、既存のメモリが拡張されるか、再利用されます。

例

例については、IAtlMemMgr の概要に関するページを参照してください。

IAxWinAmbientDispatch::get_AllowContextMenu

AllowContextMenu プロパティは、ホストされるコントロールが独自のコンテキスト メニューを表示できるかどうかを指定します。

STDMETHOD(get_AllowContextMenu)(VARIANT_BOOL* pbAllowContextMenu);

パラメーター

pbAllowContextMenu
[出力] このプロパティの現在の値を受け取る変数のアドレス。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値として VARIANT_TRUE が使用されます。

IAxWinAmbientDispatch::get_AllowShowUI

AllowShowUI プロパティは、ホストされるコントロールが独自のユーザー インターフェイスを表示できるかどうかを指定します。

STDMETHOD(get_AllowShowUI)(VARIANT_BOOL* pbAllowShowUI);

パラメーター

pbAllowShowUI
[出力] このプロパティの現在の値を受け取る変数のアドレス。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値として VARIANT_FALSE が使用されます。

IAxWinAmbientDispatch::get_AllowWindowlessActivation

AllowWindowlessActivation プロパティは、コンテナーでウィンドウなしのアクティブ化を許可するかどうかを指定します。

STDMETHOD(get_AllowWindowlessActivation)(VARIANT_BOOL* pbAllowWindowless);

パラメーター

pbAllowWindowless
[出力] このプロパティの現在の値を受け取る変数のアドレス。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値として VARIANT_TRUE が使用されます。

IAxWinAmbientDispatch::get_BackColor

BackColor プロパティは、コンテナーのアンビエント背景色を指定します。

STDMETHOD(get_BackColor)(OLE_COLOR* pclrBackground);

パラメーター

pclrBackground
[出力] このプロパティの現在の値を受け取る変数のアドレス。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値として COLOR_BTNFACE または COLOR_WINDOW が使用されます (ホスト ウィンドウの親がダイアログかどうかによって異なります)。

IAxWinAmbientDispatch::get_DisplayAsDefault

DisplayAsDefault は、コントロールで、既定のコントロールであるかを確認できるようにするアンビエント プロパティです。

STDMETHOD(get_DisplayAsDefault)(VARIANT_BOOL* pbDisplayAsDefault);

パラメーター

pbDisplayAsDefault
[出力] このプロパティの現在の値を受け取る変数のアドレス。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値として VARIANT_FALSE が使用されます。

IAxWinAmbientDispatch::get_DocHostDoubleClickFlags

DocHostDoubleClickFlags プロパティは、ダブルクリックに応答して実行する必要がある操作を指定します。

STDMETHOD(get_DocHostDoubleClickFlags)(DWORD* pdwDocHostDoubleClickFlags);

パラメーター

pdwDocHostDoubleClickFlags
[出力] このプロパティの現在の値を受け取る変数のアドレス。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値として DOCHOSTUIDBLCLK_DEFAULT が使用されます。

IAxWinAmbientDispatch::get_DocHostFlags

DocHostFlags プロパティは、ホスト オブジェクトのユーザー インターフェイス機能を指定します。

STDMETHOD(get_DocHostFlags)(DWORD* pdwDocHostFlags);

パラメーター

pdwDocHostFlags
[出力] このプロパティの現在の値を受け取る変数のアドレス。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値として DOCHOSTUIFLAG_NO3DBORDER が使用されます。

IAxWinAmbientDispatch::get_Font

Font プロパティは、コンテナーのアンビエント フォントを指定します。

STDMETHOD(get_Font)(IFontDisp** pFont);

パラメーター

pFont
[出力] このプロパティの現在値を受け取るために使用される IFontDisp インターフェイス ポインターのアドレス。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値として既定の GUI フォントまたはシステム フォントが使用されます。

IAxWinAmbientDispatch::get_ForeColor

ForeColor プロパティは、コンテナーのアンビエント前景色を指定します。

STDMETHOD(get_ForeColor)(OLE_COLOR* pclrForeground);

パラメーター

pclrForeground
[出力] このプロパティの現在の値を受け取る変数のアドレス。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値としてシステム ウィンドウのテキストの色が使用されます。

IAxWinAmbientDispatch::get_LocaleID

LocaleID プロパティは、コンテナーのアンビエント ロケール ID を指定します。

STDMETHOD(get_LocaleID)(LCID* plcidLocaleID);

パラメーター

plcidLocaleID
[出力] このプロパティの現在の値を受け取る変数のアドレス。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値としてユーザーの既定のロケールが使用されます。

このメソッドを使用すると、アンビエント LocalID、つまり、コントロールが使用されているプログラムの LocaleID を検出できます。 LocaleID がわかると、リソース ファイルまたはサテライト DLL からロケール固有のキャプションやエラー メッセージ テキストなどを読み込むコードを呼び出すことができます。

IAxWinAmbientDispatch::get_MessageReflect

MessageReflect アンビエント プロパティは、コンテナーが、ホストされるコントロールへのメッセージを反映するかどうかを指定します。

STDMETHOD(get_MessageReflect)(VARIANT_BOOL* pbMessageReflect);

パラメーター

pbMessageReflect
[出力] このプロパティの現在の値を受け取る変数のアドレス。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値として VARIANT_TRUE が使用されます。

IAxWinAmbientDispatch::get_OptionKeyPath

OptionKeyPath プロパティは、ユーザー設定へのレジストリ キー パスを指定します。

STDMETHOD(get_OptionKeyPath)(BSTR* pbstrOptionKeyPath);

パラメーター

pbstrOptionKeyPath
[出力] このプロパティの現在の値を受け取る変数のアドレス。

戻り値

標準の HRESULT 値。

IAxWinAmbientDispatch::get_ShowGrabHandles

ShowGrabHandles アンビエント プロパティを使用すると、コントロールがグラブ ハンドルを使用してそれ自体を描画する必要があるかどうかを判断できます。

STDMETHOD(get_ShowGrabHandles)(VARIANT_BOOL* pbShowGrabHandles);

パラメーター

pbShowGrabHandles
[出力] このプロパティの現在の値を受け取る変数のアドレス。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの値として常に VARIANT_FALSE が返されます。

IAxWinAmbientDispatch::get_ShowHatching

ShowHatching アンビエント プロパティは、ハッチングを使ってコントロール自体を描画する必要があるかどうかをコントロールで確認できるようにします。

STDMETHOD(get_ShowHatching)(VARIANT_BOOL* pbShowHatching);

パラメーター

pbShowHatching
[出力] このプロパティの現在の値を受け取る変数のアドレス。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの値として常に VARIANT_FALSE が返されます。

IAxWinAmbientDispatch::get_UserMode

UserMode プロパティは、コンテナーのアンビエント ユーザー モードを指定します。

STDMETHOD(get_UserMode)(VARIANT_BOOL* pbUserMode);

パラメーター

pbUserMode
[出力] このプロパティの現在の値を受け取る変数のアドレス。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値として VARIANT_TRUE が使用されます。

IAxWinAmbientDispatch::put_AllowContextMenu

AllowContextMenu プロパティは、ホストされるコントロールが独自のコンテキスト メニューを表示できるかどうかを指定します。

STDMETHOD(put_AllowContextMenu)(VARIANT_BOOL bAllowContextMenu);

パラメーター

bAllowContextMenu
[入力] このプロパティの新しい値。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値として VARIANT_TRUE が使用されます。

IAxWinAmbientDispatch::put_AllowShowUI

AllowShowUI プロパティは、ホストされるコントロールが独自のユーザー インターフェイスを表示できるかどうかを指定します。

STDMETHOD(put_AllowShowUI)(VARIANT_BOOL bAllowShowUI);

パラメーター

bAllowShowUI
[入力] このプロパティの新しい値。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値として VARIANT_FALSE が使用されます。

IAxWinAmbientDispatch::put_AllowWindowlessActivation

AllowWindowlessActivation プロパティは、コンテナーでウィンドウなしのアクティブ化を許可するかどうかを指定します。

STDMETHOD(put_AllowWindowlessActivation)(VARIANT_BOOL bAllowWindowless);

パラメーター

bAllowWindowless
[入力] このプロパティの新しい値。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値として VARIANT_TRUE が使用されます。

IAxWinAmbientDispatch::put_BackColor

BackColor プロパティは、コンテナーのアンビエント背景色を指定します。

STDMETHOD(put_BackColor)(OLE_COLOR clrBackground);

パラメーター

clrBackground
[入力] このプロパティの新しい値。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値として COLOR_BTNFACE または COLOR_WINDOW が使用されます (ホスト ウィンドウの親がダイアログかどうかによって異なります)。

IAxWinAmbientDispatch::put_DisplayAsDefault

DisplayAsDefault は、コントロールで、既定のコントロールであるかを確認できるようにするアンビエント プロパティです。

STDMETHOD(put_DisplayAsDefault)(VARIANT_BOOL bDisplayAsDefault);

パラメーター

bDisplayAsDefault
[入力] このプロパティの新しい値。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値として VARIANT_FALSE が使用されます。

IAxWinAmbientDispatch::put_DocHostDoubleClickFlags

DocHostDoubleClickFlags プロパティは、ダブルクリックに応答して実行する必要がある操作を指定します。

STDMETHOD(put_DocHostDoubleClickFlags)(DWORD dwDocHostDoubleClickFlags);

パラメーター

dwDocHostDoubleClickFlags
[入力] このプロパティの新しい値。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値として DOCHOSTUIDBLCLK_DEFAULT が使用されます。

IAxWinAmbientDispatch::put_DocHostFlags

DocHostFlags プロパティは、ホスト オブジェクトのユーザー インターフェイス機能を指定します。

STDMETHOD(put_DocHostFlags)(DWORD dwDocHostFlags);

パラメーター

dwDocHostFlags
[入力] このプロパティの新しい値。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値として DOCHOSTUIFLAG_NO3DBORDER が使用されます。

IAxWinAmbientDispatch::put_Font

Font プロパティは、コンテナーのアンビエント フォントを指定します。

STDMETHOD(put_Font)(IFontDisp* pFont);

パラメーター

pFont
[入力] このプロパティの新しい値。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値として既定の GUI フォントまたはシステム フォントが使用されます。

IAxWinAmbientDispatch::put_ForeColor

ForeColor プロパティは、コンテナーのアンビエント前景色を指定します。

STDMETHOD(put_ForeColor)(OLE_COLOR clrForeground);

パラメーター

clrForeground
[入力] このプロパティの新しい値。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値としてシステム ウィンドウのテキストの色が使用されます。

IAxWinAmbientDispatch::put_LocaleID

LocaleID プロパティは、コンテナーのアンビエント ロケール ID を指定します。

STDMETHOD(put_LocaleID)(LCID lcidLocaleID);

パラメーター

lcidLocaleID
[入力] このプロパティの新しい値。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値としてユーザーの既定のロケールが使用されます。

IAxWinAmbientDispatch::put_MessageReflect

MessageReflect アンビエント プロパティは、コンテナーが、ホストされるコントロールへのメッセージを反映するかどうかを指定します。

STDMETHOD(put_MessageReflect)(VARIANT_BOOL bMessageReflect);

パラメーター

bMessageReflect
[入力] このプロパティの新しい値。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値として VARIANT_TRUE が使用されます。

IAxWinAmbientDispatch::put_OptionKeyPath

OptionKeyPath プロパティは、ユーザー設定へのレジストリ キー パスを指定します。

STDMETHOD(put_OptionKeyPath)(BSTR bstrOptionKeyPath);

パラメーター

bstrOptionKeyPath
[入力] このプロパティの新しい値。

戻り値

標準の HRESULT 値。

IAxWinAmbientDispatch::put_UserMode

UserMode プロパティは、コンテナーのアンビエント ユーザー モードを指定します。

STDMETHOD(put_UserMode)(VARIANT_BOOL bUserMode);

パラメーター

bUserMode
[入力] このプロパティの新しい値。

戻り値

標準の HRESULT 値。

解説

ATL ホスト オブジェクトの実装で、このプロパティの既定値として VARIANT_TRUE が使用されます。

IAxWinAmbientDispatchEx::SetAmbientDispatch

このメソッドは、ユーザー定義のインターフェイスを使用して、既定のアンビエントプロパティインターフェイスを補うために呼び出されます。

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

パラメーター

pDispatch
新しいインターフェイスへのポインター。

戻り値

成功した場合は S_OK、失敗した場合はエラー HRESULT を返します。

解説

新しいインターフェイスへのポインターを使用して SetAmbientDispatch が呼び出されると、ホストされたコントロールから要求されるプロパティまたはメソッドを呼び出すために、この新しいインターフェイスが使用されます (それらのプロパティがまだ IAxWinAmbientDispatch により提供されていない場合)。

IAxWinHostWindow::AttachControl

hWnd により識別されるウィンドウを使用して、既存の (かつ以前に初期化されている) コントロールをホスト オブジェクトにアタッチします。

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

パラメーター

pUnkControl
[入力] ホスト オブジェクトにアタッチされるコントロールの IUnknown インターフェイスへのポインター。

hWnd
[入力] ホスティングに使用されるウィンドウへのハンドル。

戻り値

標準の HRESULT 値。

IAxWinHostWindow::CreateControl

コントロールを作成して初期化し、hWnd によって識別されるウィンドウでホストします。

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

パラメーター

lpTricsData
[入力] 作成するコントロールを識別する文字列。 CLSID (中かっこを含める必要がある)、ProgID、URL、または未加工の HTML (MSHTML: のプレフィックス付き) にすることができます。

hWnd
[入力] ホスティングに使用されるウィンドウへのハンドル。

pStream
[入力] コントロールの初期化データを含むストリームのインターフェイス ポインター。 NULL にすることができます。

戻り値

標準の HRESULT 値。

解説

このウィンドウは、このインターフェイスを公開するホスト オブジェクトによってサブクラス化されるため、メッセージをコントロールに反映でき、その他のコンテナー機能が動作するようになります。

このメソッドを呼び出すことは、IAxWinHostWindow::CreateControlEx を呼び出すことと同じです。

ライセンスされた ActiveX コントロールを作成する場合は、「IAxWinHostWindowLic::CreateControlLic」を参照してください。

IAxWinHostWindow::CreateControlEx

ActiveX コントロールを作成して初期化し、指定されたウィンドウでホストします。これは、IAxWinHostWindow::CreateControl と似ています。

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

パラメーター

lpTricsData
[入力] 作成するコントロールを識別する文字列。 CLSID (中かっこを含める必要がある)、ProgID、URL、または未加工の HTML (MSHTML: のプレフィックス付き) にすることができます。

hWnd
[入力] ホスティングに使用されるウィンドウへのハンドル。

pStream
[入力] コントロールの初期化データを含むストリームのインターフェイス ポインター。 NULL にすることができます。

ppUnk
[出力] 作成されたコントロールの IUnknown インターフェイスを受け取るポインターのアドレス。 NULL にすることができます。

riidAdvise
[入力] 含まれるオブジェクトの発信インターフェイスのインターフェイス識別子。 IID_NULL にすることができます。

punkAdvise
[入力] iidSink で指定された含まれるオブジェクトの接続ポイントに接続されるシンク オブジェクトの IUnknown インターフェイスへのポインター。

戻り値

標準の HRESULT 値。

解説

CreateControl メソッドとは異なり、CreateControlEx の場合も新しく作成されたコントロールへのインターフェイス ポインターを受け取り、コントロールによって発生するイベントを受け取るようにイベント シンクを設定することができます。

ライセンスされた ActiveX コントロールを作成する場合は、「IAxWinHostWindowLic::CreateControlLicEx」を参照してください。

IAxWinHostWindow::QueryControl

ホストされたコントロールによって提供される指定されたインターフェイス ポインターを返します。

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

パラメーター

riid
[入力] 要求されているコントロールのインターフェイスの ID。

ppvObject
[出力] 作成されたコントロールの指定されたインターフェイスを受け取るポインターのアドレス。

戻り値

標準の HRESULT 値。

IAxWinHostWindow::SetExternalDispatch

IDocHostUIHandlerDispatch::GetExternal メソッドを使用して含まれているコントロールで使用できる外部のディスパッチ インターフェイスを設定します。

STDMETHOD(SetExternalDispatch)(IDispatch* pDisp);

パラメーター

pDisp
[入力] IDispatch インターフェイスへのポインター。

戻り値

標準の HRESULT 値。

IAxWinHostWindow::SetExternalUIHandler

CAxWindow オブジェクトの外部 IDocHostUIHandlerDispatch インターフェイスを設定するには、この関数を呼び出します。

STDMETHOD(SetExternalUIHandler)(IDocHostUIHandlerDispatch* pDisp);

パラメーター

pDisp
[入力] IDocHostUIHandlerDispatch インターフェイスへのポインター。

戻り値

標準の HRESULT 値。

解説

この関数は、IDocHostUIHandlerDispatch インターフェイスについてホストのサイトにクエリを実行するコントロール (Web ブラウザー コントロールなど) によって使用されます。

IAxWinHostWindowLic::CreateControlLic

ライセンスされたコントロールを作成して初期化し、hWnd によって識別されるウィンドウでホストします。

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

パラメーター

bstrLic
[入力] コントロールのライセンス キーを含む BSTR。

解説

残りのパラメーターと戻り値の説明については、「IAxWinHostWindow::CreateControl」を参照してください。

このメソッドを呼び出すことは、IAxWinHostWindowLic::CreateControlLicEx を呼び出すことと同じです

例

IAxWinHostWindowLic::CreateControlLic を使用する例については、「ATL AXHost を使用して ActiveX コントロールをホストする」を参照してください。

IAxWinHostWindowLic::CreateControlLicEx

ライセンスされた ActiveX コントロールを作成して初期化し、指定されたウィンドウでホストします。これは、IAxWinHostWindow::CreateControl と似ています。

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

パラメーター

bstrLic
[入力] コントロールのライセンス キーを含む BSTR。

解説

残りのパラメーターと戻り値の説明については、「IAxWinHostWindow::CreateControlEx」を参照してください。

例

IAxWinHostWindowLic::CreateControlLicEx を使用する例については、「ATL AXHost を使用して ActiveX コントロールをホストする」を参照してください。

関連項目

クラスの概要