interface IDualEngine20BrowserSession

Importante

A API DualEngine faz parte de um Recurso de Acesso Limitado (consulte a classe LimitedAccessFeatures). Para obter mais informações ou solicitar um token de desbloqueio, entre em contato com o Suporte da Microsoft.

interface IDualEngine20BrowserSession
  : public IUnknown

Representa uma sessão de processo do Internet Explorer.

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 os arquivos de dados de recuperação de guia, exceto os 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 as mensagens de detecção de travamentos que serão enviadas para a sessão pelo host para detectar travamentos.
SetHostIntranetInInternetExplorer Define se todos os sites da Intranet devem ser abertos na sessão.
SetHybridMode Define se o tratamento de lista de sites deve ser habilitado no Modo Híbrido.
SetReverseCookieSync Define se as alterações de cookie são sincronizadas de volta com o host.
SetSitePermissions Define as permissões de site para a sessão.
SetUseAdditionalHangDetection Define se detecções de trava adicionais devem ser habilitadas.
ShowDownloadWindow Mostra a janela de download do Internet Explorer.
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.

público, HRESULT, CloneActiveTabRecoveryData(HWND, hwndBrowser, REFGUID, guidSrcFile, REFGUID, guidDestFile)

Parâmetros

  • hwndBrowser O HWND da janela do navegador hospedada.

  • 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.

público 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.

público HRESULT CreateDualEngineBrowser(IDualEngine20Browser ** ppDualEngineBrowser)

Parâmetros
  • ppDualEngineBrowser O novo objeto Browser.

DeleteAllButRecoverableRecoveryFiles

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

público HRESULT DeleteAllButRecoverableRecoveryFiles(int cRecoverableGUIDs, LPCWSTR * rgpszRecoverableGUIDs)

Parâmetros

  • cRecoverableGUIDs O número de GUIDs no rgpszRecoverableGUIDsformato .

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

DeleteInactiveRegionRecoveryData

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

público 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 terminar, 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 encaminhar a sessão ao host.

  • pSessionObserver Um observador para os eventos desta sessão.

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

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

ParseEmieSitelist

Analisa o XML da lista de sites no caminho fornecido.

público 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.

público HRESULT SetConfigurableSitesFlags(DualEngineConfigurableSitesFlags flags)

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

SetHangDetectionMessages

Define as mensagens de detecção de travamentos que serão enviadas para a sessão pelo host para detectar travamentos.

público HRESULT SetHangDetectionMessages(UINT uiSyncHungCheckMsg, UINT uiAsyncHungCheckMsg)

Parâmetros

  • uiSyncHungCheckMsg A ID da mensagem de janela da mensagem que o host aguardará de forma síncrona para ser tratada.

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

SetHostIntranetInInternetExplorer

Define se todos os sites da Intranet devem ser abertos na sessão.

público 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 o tratamento de lista de sites deve ser habilitado no Modo Híbrido.

público HRESULT SetHybridMode(BOOL fEnable)

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

SetReverseCookieSync

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

público HRESULT SetReverseCookieSync(BOOL fEnable)

Parâmetros

SetSitePermissions

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

público HRESULT SetSitePermissions(SITE_PERMISSION_KIND sitePermissionKind, LPCWSTR pszPermissionData)

Parâmetros

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

  • 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 detecções de trava adicionais devem ser habilitadas.

público HRESULT SetUseAdditionalHangDetection(BOOL fEnable)

Parâmetros
  • fEnable Caso truecontrário, outras detecções de trava serão habilitadas; caso contrário, elas não serão.

ShowDownloadWindow

Mostra a janela de download do Internet Explorer.

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 no pCookiesformato .

  • Last updated on