интерфейс IDualEngine20BrowserSession

Важно!

API DualEngine является частью функции ограниченного доступа (см. раздел Класс LimitedAccessFeatures). Дополнительные сведения или запрос маркера разблокировки см. в служба поддержки Майкрософт.

interface IDualEngine20BrowserSession
  : public IUnknown

Представляет сеанс обработки Обозреватель Интернета.

Сводка

Members	Описания
CloneActiveTabRecoveryData	Дублирует данные восстановления активной вкладки.
CloneInactiveTabRecoveryData	Дублирует данные восстановления неактивной вкладки.
CreateDualEngineBrowser	Создает объект Browser в этом сеансе.
DeleteAllButRecoverableRecoveryFiles	Удаляет все файлы данных восстановления, кроме предоставленной вкладки.
DeleteInactiveRegionRecoveryData	Удаляет данные восстановления вкладки неактивного региона.
GetRequestedHostForwardedAccelerators	Возвращает список ускорителей клавиатуры, которые должны быть переадресованы с узла.
Initialize	Инициализирует сеанс.
ParseEmieSitelist	Анализирует XML-код списка сайта по указанному пути.
SetConfigurableSitesFlags	Задает флаги, определяющие обработку настраиваемых сайтов.
SetHangDetectionMessages	Задает сообщения об обнаружении зависания, которые будут отправляться в сеанс узлом для обнаружения зависаний.
SetHostIntranetInInternetExplorer	Задает, следует ли открывать все сайты интрасети в сеансе.
SetHybridMode	Задает, следует ли включить обработку списка сайтов в гибридном режиме.
SetReverseCookieSync	Задает, синхронизируются ли изменения файлов cookie обратно с узлом.
SetSitePermissions	Задает разрешения сайта для сеанса.
SetUseAdditionalHangDetection	Задает, следует ли включать дополнительные обнаружения зависаний.
ShowDownloadWindow	Отображает окно скачивания Обозреватель Интернета.
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 Количество идентификаторов GUID в rgpszRecoverableGUIDs.

• 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 Идентификатор профиля узла, который необходимо связать с этим сеансом.

ParseEmieSitelist

Анализирует XML-код списка сайта по указанному пути.

public HRESULT ParseEmieSitelist(LPCWSTR emieXmlPath)

Параметры

• emieXmlPath Путь к XML-файлу списка сайтов для анализа.

SetConfigurableSitesFlags

Задает флаги, определяющие обработку настраиваемых сайтов.

public HRESULT SetConfigurableSitesFlags(DualEngineConfigurableSitesFlags flags)

Параметры

• flags Флаги, указывающие, как обрабатываются настраиваемые сайты.

SetHangDetectionMessages

Задает сообщения об обнаружении зависания, которые будут отправляться в сеанс узлом для обнаружения зависаний.

public HRESULT SetHangDetectionMessages(UINT uiSyncHungCheckMsg, UINT uiAsyncHungCheckMsg)

Параметры

• uiSyncHungCheckMsg Идентификатор сообщения окна, в котором будет синхронно ожидать обработки узла.

• uiAsyncHungCheckMsg Идентификатор сообщения окна, в котором асинхронно ожидает узел. Браузеры сигналит об узле, вызывая IDualEngine20BrowserObserver::OnAsyncHungCheckReply().

SetHostIntranetInInternetExplorer

Задает, следует ли открывать все сайты интрасети в сеансе.

public HRESULT SetHostIntranetInInternetExplorer(BOOL fEnable)

Параметры

• fEnable Если trueзадано значение , навигация по сайтам интрасети останется в сеансе; в противном случае будет ли навигация оставаться в сеансе или не соответствовать логике определения по умолчанию.

SetHybridMode

Задает, следует ли включить обработку списка сайтов в гибридном режиме.

public HRESULT SetHybridMode(BOOL fEnable)

Параметры

• fEnable Если trueзадано значение , при обработке URL-адресов списка сайтов включено поведение гибридного режима; в противном случае происходит нормальное поведение навигации.

SetReverseCookieSync

Задает, синхронизируются ли изменения файлов cookie обратно с узлом.

public HRESULT SetReverseCookieSync(BOOL fEnable)

Параметры

• fEnable Если trueзадано значение , узел будет уведомлен об изменениях файлов cookie событием IDualEngine20BrowserSessionObserver::ReverseSyncCookies(); в противном случае это не так.

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

См. также:

• Приложение А. Собранный ABNF для URI в RFC 3986 — универсальный код ресурса (URI): универсальный синтаксис.

SetUseAdditionalHangDetection

Задает, следует ли включать дополнительные обнаружения зависаний.

public HRESULT SetUseAdditionalHangDetection(BOOL fEnable)

Параметры

• fEnable Если trueзначение , дополнительные обнаружения зависаний будут включены; в противном случае они не будут.

ShowDownloadWindow

Отображает окно скачивания Обозреватель Интернета.

public HRESULT ShowDownloadWindow()

SyncCookies

Отправляет данные файлов cookie в процесс сеанса.

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

Параметры

• pCookies Массив файлов cookie для отправки в сеанс.

• cCookies Количество элементов в pCookies.