重要
DualEngine API は、制限付きアクセス機能の一部です ( 「LimitedAccessFeatures クラス」を参照してください)。 詳細については、またはロック解除トークンを要求するには、Microsoft サポートにお問い合わせください。
interface IDualEngine20BrowserSession
: public IUnknown
インターネット エクスプローラー プロセス セッションを表します。
まとめ
| メンバー | 説明 |
|---|---|
| CloneActiveTabRecoveryData | アクティブなタブの回復データを複製します。 |
| CloneInactiveTabRecoveryData | 非アクティブなタブの回復データを複製します。 |
| CreateDualEngineBrowser | このセッションで Browser オブジェクトを作成します。 |
| DeleteAllButRecoverableRecoveryFiles | 指定されたタブ回復データ ファイル以外のすべてを削除します。 |
| DeleteInactiveRegionRecoveryData | 非アクティブなリージョンのタブ回復データを削除します。 |
| GetRequestedHostForwardedAccelerators | ホストから転送する必要があるキーボード アクセラレータの一覧を返します。 |
| Initialize | セッションを初期化します。 |
| ParseEmieSitelist | 指定されたパスにあるサイトリスト XML を解析します。 |
| SetConfigurableSitesFlags | 構成可能なサイトの処理方法を決定するフラグを設定します。 |
| SetHangDetectionMessages | ハングを検出するためにホストによってセッションに送信されるハング検出メッセージを設定します。 |
| SetHostIntranetInInternetExplorer | セッション内のすべてのイントラネット サイトを開くかどうかを設定します。 |
| SetHybridMode | ハイブリッド モード サイトリスト処理を有効にするかどうかを設定します。 |
| SetReverseCookieSync | Cookie の変更をホストに同期するかどうかを設定します。 |
| SetSitePermissions | セッションのサイトアクセス許可を設定します。 |
| SetUseAdditionalHangDetection | 追加のハング検出を有効にするかどうかを設定します。 |
| ShowDownloadWindow | [インターネット エクスプローラーダウンロード] ウィンドウが表示されます。 |
| SyncCookies | セッション プロセスに Cookie データを送信します。 |
適用対象
| Product | 導入 |
|---|---|
| バージョン 20H1 Windows 10 | KB5032278 |
| バージョン 22H2 Windows 11 | KB5032288 |
メンバー
CloneActiveTabRecoveryData
アクティブなタブの回復データを複製します。
public HRESULT CloneActiveTabRecoveryData(HWND hwndBrowser, REFGUID guidSrcFile, REFGUID guidDestFile)
パラメーター
hwndBrowserホストされているブラウザー ウィンドウの HWND。guidSrcFileコピーするソース回復データ ファイルの GUID。guidDestFile新しいタブ回復データ ファイルに関連付ける GUID。
CloneInactiveTabRecoveryData
非アクティブなタブの回復データを複製します。
public HRESULT CloneInactiveTabRecoveryData(REFGUID guidSrcFile, REFGUID guidDestFile)
パラメーター
guidSrcFileコピーするソース回復データ ファイルの GUID。guidDestFile新しいタブ回復データ ファイルに関連付ける GUID。
CreateDualEngineBrowser
このセッションで Browser オブジェクトを作成します。
public HRESULT CreateDualEngineBrowser(IDualEngine20Browser ** ppDualEngineBrowser)
パラメーター
-
ppDualEngineBrowser新しい Browser オブジェクト。
DeleteAllButRecoverableRecoveryFiles
指定されたタブ回復データ ファイル以外のすべてを削除します。
public HRESULT DeleteAllButRecoverableRecoveryFiles(int cRecoverableGUIDs, LPCWSTR * rgpszRecoverableGUIDs)
パラメーター
cRecoverableGUIDsrgpszRecoverableGUIDsの GUID の数。rgpszRecoverableGUIDs削除しないタブ回復データ ファイルを表す GUID の配列。
DeleteInactiveRegionRecoveryData
非アクティブなリージョンのタブ回復データを削除します。
public HRESULT DeleteInactiveRegionRecoveryData(REFGUID guidTabId)
パラメーター
-
guidTabId削除する回復データの GUID。
GetRequestedHostForwardedAccelerators
ホストから転送する必要があるキーボード アクセラレータの一覧を返します。
public HRESULT GetRequestedHostForwardedAccelerators(DWORD * pcAccels, ACCELERATOR ** prgAccels)
パラメーター
pcAccelsprgAccels内のアクセラレータの数。prgAccels転送する必要があるキーボード アクセラレータの一覧。 完了したら、呼び出し元は、CoTaskMemFreeを使用してリストに割り当てられたメモリを解放する必要があります。
Initialize
セッションを初期化します。
public HRESULT Initialize(DWORD cAccels, ACCELERATOR * rgHostPriorityAccels, IDualEngine20BrowserSessionObserver * pSessionObserver, LPCWSTR pszProfilePath, LPCWSTR pszProfileId)
パラメーター
cAccelsrgHostPriorityAccels内のアクセラレータの数。rgHostPriorityAccelsセッションをホストに転送するキーボード アクセラレータの一覧。pSessionObserverこのセッションからのイベントのオブザーバー。pszProfilePathセッションが関連ファイルを格納するホストのプロファイル パスへのパス。pszProfileIdこのセッションに関連付けるホストのプロファイル ID。
ParseEmieSitelist
指定されたパスにあるサイトリスト XML を解析します。
public HRESULT ParseEmieSitelist(LPCWSTR emieXmlPath)
パラメーター
-
emieXmlPath解析するサイトリスト XML へのパス。
SetConfigurableSitesFlags
構成可能なサイトの処理方法を決定するフラグを設定します。
public HRESULT SetConfigurableSitesFlags(DualEngineConfigurableSitesFlags フラグ)
パラメーター
-
flags構成可能なサイトの処理方法を示すフラグ。
SetHangDetectionMessages
ハングを検出するためにホストによってセッションに送信されるハング検出メッセージを設定します。
public HRESULT SetHangDetectionMessages(UINT uiSyncHungCheckMsg, UINT uiAsyncHungCheckMsg)
パラメーター
uiSyncHungCheckMsgホストが処理を同期的に待機するメッセージのウィンドウ メッセージ ID。uiAsyncHungCheckMsgホストが非同期的に待機するメッセージのウィンドウ メッセージ ID。 ブラウザーは 、IDualEngine20BrowserObserver::OnAsyncHungCheckReply()を呼び出すことによってホストに通知します。
SetHostIntranetInInternetExplorer
セッション内のすべてのイントラネット サイトを開くかどうかを設定します。
public HRESULT SetHostIntranetInInternetExplorer(BOOL fEnable)
パラメーター
-
fEnabletrue場合、イントラネット サイトへのナビゲーションはセッションに残ります。それ以外の場合は、ナビゲーションがセッションに留まるかどうかが既定の決定ロジックに従います。
SetHybridMode
ハイブリッド モード サイトリスト処理を有効にするかどうかを設定します。
public HRESULT SetHybridMode(BOOL fEnable)
パラメーター
-
fEnabletrue場合、サイト リスト URL を処理するときにハイブリッド モードの動作が有効になります。それ以外の場合は、通常のナビゲーション動作が発生します。
SetReverseCookieSync
Cookie の変更をホストに同期するかどうかを設定します。
public HRESULT SetReverseCookieSync(BOOL fEnable)
パラメーター
-
fEnabletrue場合、ホストは IDualEngine20BrowserSessionObserver::ReverseSyncCookies() イベントによって Cookie の変更を通知されます。それ以外の場合は通知されません。
SetSitePermissions
セッションのサイトアクセス許可を設定します。
public HRESULT SetSitePermissions(SITE_PERMISSION_KIND sitePermissionKind, LPCWSTR pszPermissionData)
パラメーター
sitePermissionKind設定されているサイトのアクセス許可の種類。pszPermissionData設定するアクセス許可データのシリアル化された文字列。
pszPermissionData は、次の BNF 形式の文字列です。
permission-data = default-action CRLF site-permissions
; Indicates the default action to take if there is no specific rule for the URI.
; DefaultAllow - Allow permission requests.
; DefaultAsk - Prompt the user for how they want to respond to the request.
; DefaultBlock - Block permission requests.
default-action = "DefaultAllow" | "DefaultAsk" | "DefaultBlock"
; A list of sites and the action to take when permission is requested.
site-permissions = *(permission SP wildcard SP scheme-part SP host-part SP
port-part SP path-part CRLF)
; Indicates the action to take on a request.
; A - Allow permission requests.
; Q - Prompt the user for how they want to respond to the request.
; B - Block permission requests.
permission = "A" | "Q" | "B"
; Indicates if the host contains a domain wildcard.
wildcard = BIT
; Can be either a specific scheme, a wildcard to match all schemes, or "!" to indicate no scheme.
scheme-part = "*" | "!" | scheme
; Can be either a specific hostname or a wildcard to match all hostnames.
host-part = "*" | host
; Represents a mostly typical URI host.
; The exception is that the host may start with a domain wildcard (e.g [*.]) which matches the host
; and any subdomains.
host = ([ subdomain-wildcard ] reg-name) | IPv4address | IP-literal
subdomain-wildcard = "[*.]"
; Can be either a specific path or a wildcard to match all paths.
path-part = "*" | path
; Can be either a specific port or a wildcard to match all ports.
port-part = "*" | port
port = *DIGIT
; For definitions of the following rules, see RFC 3986 Appendix A (https://www.rfc-editor.org/rfc/rfc3986#appendix-A):
; scheme, reg-name, IPv4address, IP-literal, path
関連項目:
- 付録 A. RFC 3986 の URI 用に収集された ABNF- Uniform Resource Identifier (URI): ジェネリック構文。
SetUseAdditionalHangDetection
追加のハング検出を有効にするかどうかを設定します。
public HRESULT SetUseAdditionalHangDetection(BOOL fEnable)
パラメーター
-
fEnabletrue場合、追加のハング検出が有効になります。それ以外の場合は有効になりません。
ShowDownloadWindow
[インターネット エクスプローラーダウンロード] ウィンドウが表示されます。
public HRESULT ShowDownloadWindow()
SyncCookies
セッション プロセスに Cookie データを送信します。
public HRESULT SyncCookies(const DualEngineCookie * pCookies, DWORD cCookies)
パラメーター
pCookiesセッションに送信される Cookie の配列。cCookiespCookies内の項目の数。