Compartilhar via

interface IDualEngine20BrowserSession

  • Artigo

Importante

A API Do DualEngine faz parte de um recurso de acesso limitado (confira Classe LimitedAccessFeatures). Para obter mais informações ou solicitar um token de desbloqueio, entre em contato com Suporte da Microsoft.

interface IDualEngine20BrowserSession
  : public IUnknown

Representa uma sessão de processo de Explorer da Internet.

Resumo

Members Descrições
CloneActiveTabRecoveryData Duplica os dados de recuperação de uma guia ativa.
CloneInactiveTabRecoveryData Duplica os dados de recuperação de uma guia inativa.
CreateDualEngineBrowser Cria um objeto Browser nesta sessão.
DeleteAllButRecoverableRecoveryFiles Exclui todos, menos os arquivos de dados de recuperação de guia fornecidos.
DeleteInactiveRegionRecoveryData Exclui os dados de recuperação de guia de uma região inativa.
GetRequestedHostForwardedAccelerators Retorna uma lista de aceleradores de teclado que devem ser encaminhados do Host.
Initialize Inicializa a sessão.
ParseEmieSitelist Analisa o XML da lista de sites no caminho fornecido.
SetConfigurableSitesFlags Define sinalizadores que determinam como os sites configuráveis são tratados.
SetHangDetectionMessages Define mensagens de detecção de travamento que serão enviadas à sessão pelo host para detectar travas.
SetHostIntranetInInternetExplorer Define se deve abrir todos os sites da Intranet na sessão.
SetHybridMode Define se deseja habilitar o tratamento de lista de sites do Modo Híbrido.
SetReverseCookieSync Define se as alterações de cookie são sincronizadas de volta ao host.
SetSitePermissions Define permissões de site para a sessão.
SetUseAdditionalHangDetection Define se deve habilitar detecções de travas adicionais.
ShowDownloadWindow Mostra a janela de download do Explorer da Internet.
SyncCookies Envia dados de cookie para o processo de sessão.

Aplicável a

Produto Introduzido
Windows 10, versão 20H1 KB5032278
Windows 11, versão 22H2 KB5032288

Members

CloneActiveTabRecoveryData

Duplica os dados de recuperação de uma guia ativa.

public HRESULT CloneActiveTabRecoveryData(HWND hwndBrowser, REFGUID guidSrcFile, REFGUID guidDestFile)

Parâmetros

  • hwndBrowser O HWND da janela do navegador hospedado.

  • guidSrcFile O GUID para o arquivo de dados de recuperação de origem a ser copiado.

  • guidDestFile O GUID a ser associado ao novo arquivo de dados de recuperação de guia.

CloneInactiveTabRecoveryData

Duplica os dados de recuperação de uma guia inativa.

public HRESULT CloneInactiveTabRecoveryData(REFGUID guidSrcFile, REFGUID guidDestFile)

Parâmetros

  • guidSrcFile O GUID para o arquivo de dados de recuperação de origem a ser copiado.

  • guidDestFile O GUID a ser associado ao novo arquivo de dados de recuperação de guia.

CreateDualEngineBrowser

Cria um objeto Browser nesta sessão.

public HRESULT CreateDualEngineBrowser(IDualEngine20Browser ** ppDualEngineBrowser)

Parâmetros
  • ppDualEngineBrowser O novo objeto Browser.

DeleteAllButRecoverableRecoveryFiles

Exclui todos, menos os arquivos de dados de recuperação de guia fornecidos.

public HRESULT DeleteAllButRecoverableRecoveryFiles(int cRecoverableGUIDs, LPCWSTR * rgpszRecoverableGUIDs)

Parâmetros

  • cRecoverableGUIDs O número de GUIDs em rgpszRecoverableGUIDs.

  • rgpszRecoverableGUIDs Uma matriz de GUIDs que representam arquivos de dados de recuperação de guias que não devem ser excluídos.

DeleteInactiveRegionRecoveryData

Exclui os dados de recuperação de guia de uma região inativa.

public HRESULT DeleteInactiveRegionRecoveryData(REFGUID guidTabId)

Parâmetros
  • guidTabId O GUID dos dados de recuperação a serem excluídos.

GetRequestedHostForwardedAccelerators

Retorna uma lista de aceleradores de teclado que devem ser encaminhados do Host.

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

Parâmetros

  • pcAccels O número de aceleradores em prgAccels.

  • prgAccels Uma lista de aceleradores de teclado que devem ser encaminhados. Quando concluído, o chamador deve liberar a memória alocada para a lista com CoTaskMemFree.

Inicializar

Inicializa a sessão.

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

Parâmetros

  • cAccels O número de aceleradores em rgHostPriorityAccels.

  • rgHostPriorityAccels Uma lista de aceleradores de teclado para que a sessão seja encaminhada para o host.

  • pSessionObserver Um observador de eventos desta sessão.

  • pszProfilePath O caminho para o caminho de perfil do host em que a sessão armazenará arquivos relevantes.

  • pszProfileId A ID do perfil do host a ser associada a essa sessão.

ParseEmieSitelist

Analisa o XML da lista de sites no caminho fornecido.

public HRESULT ParseEmieSitelist(LPCWSTR emieXmlPath)

Parâmetros
  • emieXmlPath Caminho para o XML da lista de sites a ser analisado.

SetConfigurableSitesFlags

Define sinalizadores que determinam como os sites configuráveis são tratados.

public HRESULT SetConfigurableSitesFlags(DualEngineConfigurableSitesFlags flags)

Parâmetros
  • flags Os sinalizadores que indicam como os sites configuráveis são tratados.

SetHangDetectionMessages

Define mensagens de detecção de travamento que serão enviadas à sessão pelo host para detectar travas.

public HRESULT SetHangDetectionMessages(UINT uiSyncHungCheckMsg, UINT uiAsyncHungCheckMsg)

Parâmetros

  • uiSyncHungCheckMsg A ID da mensagem de janela da qual o host aguardará síncronamente para ser manipulado.

  • uiAsyncHungCheckMsg A ID da mensagem de janela da qual o host aguardará assíncronamente. Os navegadores sinalizam o host chamando IDualEngine20BrowserObserver::OnAsyncHungCheckReply().

SetHostIntranetInInternetExplorer

Define se deve abrir todos os sites da Intranet na sessão.

public HRESULT SetHostIntranetInInternetExplorer(BOOL fEnable)

Parâmetros
  • fEnable Se true, a navegação para sites da Intranet permanecerá na sessão; caso contrário, se uma navegação permanecerá na sessão ou não seguirá a lógica de determinação padrão.

SetHybridMode

Define se deseja habilitar o tratamento de lista de sites do Modo Híbrido.

public HRESULT SetHybridMode(BOOL fEnable)

Parâmetros
  • fEnable Se true, o comportamento do Modo Híbrido estiver habilitado ao manipular URLs de lista de sites; caso contrário, ocorrerá um comportamento de navegação normal.

SetReverseCookieSync

Define se as alterações de cookie são sincronizadas de volta ao host.

public HRESULT SetReverseCookieSync(BOOL fEnable)

Parâmetros

SetSitePermissions

Define permissões de site para a sessão.

public HRESULT SetSitePermissions(SITE_PERMISSION_KIND sitePermissionKind, LPCWSTR pszPermissionData)

Parâmetros

  • sitePermissionKind O tipo de permissão do site que está sendo definida.

  • pszPermissionData Uma cadeia de caracteres serializada dos dados de permissão a serem definidos.

pszPermissionData é uma cadeia de caracteres no seguinte formato 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

Veja também:

SetUseAdditionalHangDetection

Define se deve habilitar detecções de travas adicionais.

public HRESULT SetUseAdditionalHangDetection(BOOL fEnable)

Parâmetros
  • fEnable Se true, detecções adicionais de trava serão habilitadas; caso contrário, não serão.

ShowDownloadWindow

Mostra a janela de download do Explorer da Internet.

public HRESULT ShowDownloadWindow()

SyncCookies

Envia dados de cookie para o processo de sessão.

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

Parâmetros

  • pCookies Uma matriz de cookies a serem enviados para a sessão.

  • cCookies O número de itens em pCookies.