AtlAxCreateControlLicEx

[アーティクル]
08/09/2011

ライセンスされた ActiveX コントロールを作成して初期化し、指定されたウィンドウでホストします。新しいコントロールのインターフェイスポインターとイベントシンクも作成されます。

ATLAPI AtlAxCreateControlLicEx(
   LPCOLESTR lpszName, 
   HWND hWnd, 
   IStream* pStream,
   IUnknown** ppUnkContainer, 
   IUnknown** ppUnkControl,
   REFIID iidSink = IID_NULL, 
   IUnknown* punkSink = NULL, 
   BSTR bstrLic = NULL
);

パラメーター

lpszName
コントロールに渡される文字列へのポインター。次のいずれかの書式にする必要があります。
- "MSCAL.Calendar.7" などの ProgID。
- "{8E27C92B-1264-101C-8A2F-040224009C02}" などの CLSID。
- "https://www.microsoft.com/japan" などの URL。
- "file://\\Documents\MyDoc.doc" などのアクティブドキュメントへの参照。
- "MSHTML:<HTML><BODY>This is a line of text</BODY></HTML>" などの HTML コード片。
  
  注意
  
  HTML フラグメントを MSHTML ストリームとして指定するには、HTML フラグメントの前に "MSHTML:" を付ける必要があります。
hWnd
コントロールをアタッチするウィンドウを識別するハンドル。
pStream
コントロールのプロパティを初期化するときに使用するストリームへのポインター。 NULL の場合もあります。
ppUnkContainer
コンテナーの IUnknown を受け取るポインターのアドレス。 NULL の場合もあります。
ppUnkControl
[出力] 作成されたコントロールの IUnknown を受け取るポインターのアドレス。 NULL の場合もあります。
iidSink
含まれているオブジェクトのアウトゴーイングインターフェイスのインターフェイス ID。
punkSink
含まれているオブジェクトが作成された後に、そのオブジェクトの iidSink で識別されたコネクションポイントに接続されるシンクオブジェクトの IUnknown インターフェイスへのポインター。
bstrLic
コントロールのライセンスを含む BSTR。

戻り値

標準の HRESULT 値のいずれかを返します。

解説

AtlAxCreateControlLicEx は AtlAxCreateControlLic と似ていますが、AtlAxCreateControlLicEx では新規に作成されたコントロールへのインターフェイスポインターを受け取ったり、コントロールで発生したイベントを受け取るイベントシンクを設定したりできます。