interface IDualEngine20BrowserSession

interface IDualEngine20BrowserSession
  : public IUnknown

Representa uma sessão de processo da Internet Explorer.

Resumo

Aplicável a

Members

CloneActiveTabRecoveryData

Duplica os dados de recuperação de um separador ativo.

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

Parâmetros

• hwndBrowser O HWND da janela do browser alojado.

• guidSrcFile O GUID do ficheiro de dados de recuperação de origem a copiar.

• guidDestFile O GUID a associar ao novo ficheiro de dados de recuperação de separadores.

CloneInactiveTabRecoveryData

Duplica os dados de recuperação de um separador inativo.

public HRESULT CloneInactiveTabRecoveryData(REFGUID guidSrcFile, REFGUID guidDDestFile)

Parâmetros

• guidSrcFile O GUID do ficheiro de dados de recuperação de origem a copiar.

• guidDestFile O GUID a associar ao novo ficheiro de dados de recuperação de separadores.

CreateDualEngineBrowser

Cria um objeto browser nesta sessão.

public HRESULT CreateDualEngineBrowser(IDualEngine20Browser ** ppDualEngineBrowser)

Parâmetros

• ppDualEngineBrowser O novo objeto Browser.

DeleteAllButRecoverableRecoveryFiles

Elimina todos, exceto os ficheiros de dados de recuperação de separadores fornecidos.

public HRESULT DeleteAllButRecoverableRecoveryFiles(int cRecoverableGUIDs, LPCWSTR * rgpszRecoverableGUIDs)

Parâmetros

• cRecoverableGUIDs O número de GUIDs em rgpszRecoverableGUIDs.

• rgpszRecoverableGUIDs Uma matriz de GUIDs que representa ficheiros de dados de recuperação de separadores que não devem ser eliminados.

DeleteInactiveRegionRecoveryData

Elimina os dados de recuperação de separadores de uma região inativa.

public HRESULT DeleteInactiveRegionRecoveryData(REFGUID guidTabId)

Parâmetros

• guidTabId O GUID dos dados de recuperação a eliminar.

GetRequestedHostForwardedAccelerators

Devolve uma lista de aceleradores de teclado que devem ser reencaminhados a partir do Anfitrião.

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 reencaminhados. Quando terminar, o autor da chamada tem de libertar 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 reencaminhada para o anfitrião.

• pSessionObserver Um observador para eventos desta sessão.

• pszProfilePath O caminho para o caminho de perfil do anfitrião onde a sessão irá armazenar ficheiros relevantes.

• pszProfileId O ID de perfil do anfitrião a associar a esta 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 para analisar.

SetConfigurableSitesFlags

Define sinalizadores que determinam a forma como os sites configuráveis são processados.

public HRESULT SetConfigurableSitesFlags(DualEngineConfigurableSitesFlags flags)

Parâmetros

• flags Os sinalizadores que indicam como os sites configuráveis são processados.

SetHangDetectionMessages

Define mensagens de deteção de bloqueio que serão enviadas para a sessão pelo anfitrião para detetar bloqueios.

public HRESULT SetHangDetectionMessages(UINT uiSyncHungCheckMsg, UINT uiAsyncHungCheckMsg)

Parâmetros

• uiSyncHungCheckMsg O ID da mensagem da janela na qual o anfitrião irá aguardar síncronamente para ser processado.

• uiAsyncHungCheckMsg O ID da mensagem da janela na qual o anfitrião irá aguardar de forma assíncrona. Os browsers assinalam o anfitrião ao chamar IDualEngine20BrowserObserver::OnAsyncHungCheckReply().

SetHostIntranetInInternetExplorer

Define se pretende 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 predefinida.

SetHybridMode

Define se pretende ativar o processamento de listas de sites do Modo Híbrido.

public HRESULT SetHybridMode(BOOL fEnable)

Parâmetros

• fEnable Se true, o comportamento do Modo Híbrido estiver ativado ao processar URLs da lista de sites; caso contrário, ocorre um comportamento normal de navegação.

SetReverseCookieSync

Define se as alterações de cookies são sincronizadas novamente com o anfitrião.

public HRESULT SetReverseCookieSync(BOOL fEnable)

Parâmetros

• fEnable Se true, o anfitrião será notificado das alterações de cookies pelo evento IDualEngine20BrowserSessionObserver::ReverseSyncCookies(). Caso contrário, não será.

SetSitePermissions

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

public HRESULT SetSitePermissions(SITE_PERMISSION_KIND sitePermissionKind, LPCWSTR pszPermissionData)

Parâmetros

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

• pszPermissionData Uma cadeia serializada dos dados de permissão a definir.

pszPermissionData é uma cadeia 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:

• Apêndice A. Recolhido ABNF para URI em RFC 3986 – Uniform Resource Identifier (URI): Sintaxe Genérica.

SetUseAdditionalHangDetection

Define se pretende ativar deteções de bloqueio adicionais.

public HRESULT SetUseAdditionalHangDetection(BOOL fEnable)

Parâmetros

• fEnable Se true, serão ativadas deteções de bloqueio adicionais; caso contrário, não o farão.

ShowDownloadWindow

Mostra a janela de transferência da Internet Explorer.

public HRESULT ShowDownloadWindow()

SyncCookies

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

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

Parâmetros

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

• cCookies O número de itens em pCookies.