interface IDualEngine20BrowserSession

项目
05/21/2024

重要

DualEngine API 是受限访问功能的一部分， (请参阅 LimitedAccessFeatures 类) 。有关详细信息或请求解锁令牌，请联系 Microsoft 支持部门。

interface IDualEngine20BrowserSession
  : public IUnknown

表示 Internet Explorer 进程会话。

摘要

Members	说明
CloneActiveTabRecoveryData	复制活动选项卡的恢复数据。
CloneInactiveTabRecoveryData	复制非活动选项卡的恢复数据。
CreateDualEngineBrowser	在此会话中创建 Browser 对象。
DeleteAllButRecoverableRecoveryFiles	删除除提供的选项卡恢复数据文件的所有文件。
DeleteInactiveRegionRecoveryData	删除非活动区域的选项卡恢复数据。
GetRequestedHostForwardedAccelerators	返回应从主机转发的键盘快捷键列表。
Initialize	初始化会话。
ParseEmieSitelist	在提供的路径中分析站点列表 XML。
SetConfigurableSitesFlags	设置用于确定如何处理可配置站点的标志。
SetHangDetectionMessages	设置主机将发送到会话以检测挂起的挂起检测消息。
SetHostIntranetInInternetExplorer	设置是否打开会话中的所有 Intranet 站点。
SetHybridMode	设置是否启用混合模式站点列表处理。
SetReverseCookieSync	设置 Cookie 更改是否同步回主机。
SetSitePermissions	设置会话的网站权限。
SetUseAdditionalHangDetection	设置是否启用其他挂起检测。
ShowDownloadWindow	显示 Internet Explorer 下载窗口。
SyncCookies	将 Cookie 数据发送到会话进程。

适用对象

产品	引入
Windows 10，版本 20H1	KB5032278
Windows 11，版本 22H2	KB5032288

Members

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)

参数

cRecoverableGUIDs 中的 rgpszRecoverableGUIDsGUID 数。
rgpszRecoverableGUIDs 表示不删除的选项卡恢复数据文件的 GUID 数组。

DeleteInactiveRegionRecoveryData

删除非活动区域的选项卡恢复数据。

public HRESULT DeleteInactiveRegionRecoveryData (REFGUID guidTabId)

参数

guidTabId 要删除的恢复数据的 GUID。

GetRequestedHostForwardedAccelerators

返回应从主机转发的键盘快捷键列表。

public HRESULT GetRequestedHostForwardedAccelerators (DWORD * pcAccels， ACCELERATOR ** prgAccels)

参数

pcAccels 中的 prgAccels加速器数。
prgAccels 应转发的键盘快捷键列表。完成后，调用方必须使用释放为列表分配的 CoTaskMemFree内存。

Initialize

初始化会话。

public HRESULT Initialize (DWORD cAccels， ACCELERATOR * rgHostPriorityAccels， IDualEngine20BrowserSessionObserver * pSessionObserver， LPCWSTR pszProfilePath， LPCWSTR pszProfileId)

参数

cAccels 中的 rgHostPriorityAccels加速器数。
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

设置是否打开会话中的所有 Intranet 站点。

public HRESULT SetHostIntranetInInternetExplorer (BOOL fEnable)

参数

fEnable 如果 true为，则 Intranet 站点的导航将保留在会话中;否则，导航是否将保留在会话中，则遵循默认确定逻辑。

SetHybridMode

设置是否启用混合模式站点列表处理。

public HRESULT SetHybridMode (BOOL fEnable)

参数

fEnable 如果 true为，则当处理站点列表 URL 时启用混合模式行为;否则，将发生正常导航行为。

SetReverseCookieSync

设置 Cookie 更改是否同步回主机。

public HRESULT SetReverseCookieSync (BOOL fEnable)

参数

fEnable 如果 true为，则 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 - 统一资源标识符 (URI) ：泛型语法。

SetUseAdditionalHangDetection

设置是否启用其他挂起检测。

public HRESULT SetUseAdditionalHangDetection (BOOL fEnable)

参数

fEnable 如果 true为，则将启用其他挂起检测;否则不会。

ShowDownloadWindow

显示 Internet Explorer 下载窗口。

public HRESULT ShowDownloadWindow ()

SyncCookies

将 Cookie 数据发送到会话进程。

public HRESULT SyncCookies (const DualEngineCookie * pCookies，DWORD cCookies)

参数

pCookies 要发送到会话的 Cookie 数组。
cCookies 中的 pCookies项数。

通过