WebView2 日本語リファレンス
WebView2 › インターフェース › ICoreWebView2Environment

ICoreWebView2Environment

COM
📘 Microsoft Learn (日本語)
IIDb96d755e-0319-4e92-a296-23436f46a1fc継承元IUnknown自前メソッド開始 vtbl3

メソッド 5

vtbl = vtable インデックス(0始まり)。HSP等からインデックス指定でCOMメソッドを呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT CreateCoreWebView2Controller(HWND parentWindow, ICoreWebView2CreateCoreWebView2ControllerCompletedHandler* handler)
parentWindowHWNDinWebView をホストする親ウィンドウのハンドル(HWND)を指定する。
handlerICoreWebView2CreateCoreWebView2ControllerCompletedHandler*inコントローラ生成の完了時に結果を受け取るための ICoreWebView2CreateCoreWebView2ControllerCompletedHandler へのポインタである。
vtbl 4 HRESULT CreateWebResourceResponse(IStream* content, INT statusCode, LPWSTR reasonPhrase, LPWSTR headers, ICoreWebView2WebResourceResponse** response)
contentIStream*in応答の本文データを供給する IStream へのポインタである。本文がない場合は NULL を指定できる。
statusCodeINTinHTTP ステータスコードを指定する INT である。
reasonPhraseLPWSTRinHTTP ステータスの理由フレーズを指定する LPWSTR である。
headersLPWSTRin応答ヘッダを表す文字列を指定する LPWSTR である。
responseICoreWebView2WebResourceResponse**out生成された ICoreWebView2WebResourceResponse を受け取るポインタへのポインタである。
vtbl 5 HRESULT get_BrowserVersionString(LPWSTR* versionInfo)
versionInfoLPWSTR*outWebView2 ランタイムのブラウザーバージョン文字列を受け取る LPWSTR へのポインタである。呼び出し側が CoTaskMemFree で解放する。
vtbl 6 HRESULT add_NewBrowserVersionAvailable(ICoreWebView2NewBrowserVersionAvailableEventHandler* eventHandler, EventRegistrationToken* token)
eventHandlerICoreWebView2NewBrowserVersionAvailableEventHandler*in新しいブラウザーバージョンが利用可能になったときに呼び出されるイベントハンドラへのポインタである。
tokenEventRegistrationToken*out登録したハンドラを後で解除するための EventRegistrationToken を受け取るポインタである。
vtbl 7 HRESULT remove_NewBrowserVersionAvailable(EventRegistrationToken token)
tokenEventRegistrationTokeninadd 時に取得した、解除対象のイベント登録を識別する EventRegistrationToken を指定する。

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。WebView2 のインターフェースは環境/ローダ経由で取得するため #usecom 末尾は "{}"。

出力引数: 
#define global IID_ICoreWebView2Environment "{B96D755E-0319-4E92-A296-23436F46A1FC}"
#usecom global ICoreWebView2Environment IID_ICoreWebView2Environment "{}"
#comfunc global ICoreWebView2Environment_CreateCoreWebView2Controller       3 sptr,sptr
#comfunc global ICoreWebView2Environment_CreateWebResourceResponse          4 sptr,int,wstr,wstr,sptr
#comfunc global ICoreWebView2Environment_get_BrowserVersionString           5 var
#comfunc global ICoreWebView2Environment_add_NewBrowserVersionAvailable     6 sptr,var
#comfunc global ICoreWebView2Environment_remove_NewBrowserVersionAvailable  7 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。

関連項目

バージョン違い・関連インターフェース