interfaz IDualEngine20BrowserSession

Importante

La API DualEngine forma parte de una característica de acceso limitado (consulte La clase LimitedAccessFeatures). Para obtener más información o para solicitar un token de desbloqueo, póngase en contacto con Soporte técnico de Microsoft.

interface IDualEngine20BrowserSession
  : public IUnknown

Representa una sesión de proceso de Internet Explorer.

Resumen

Members	Descripciones
CloneActiveTabRecoveryData	Duplica los datos de recuperación de una pestaña activa.
CloneInactiveTabRecoveryData	Duplica los datos de recuperación de una pestaña inactiva.
CreateDualEngineBrowser	Crea un objeto Browser en esta sesión.
DeleteAllButRecoverableRecoveryFiles	Elimina todos los archivos de datos de recuperación de tabulación, excepto los proporcionados.
DeleteInactiveRegionRecoveryData	Elimina los datos de recuperación de tabulación de una región inactiva.
GetRequestedHostForwardedAccelerators	Devuelve una lista de aceleradores de teclado que se deben reenviar desde el host.
Initialize	Inicializa la sesión.
ParseEmieSitelist	Analiza el XML de lista de sitios en la ruta de acceso proporcionada.
SetConfigurableSitesFlags	Establece marcas que determinan cómo se controlan los sitios configurables.
SetHangDetectionMessages	Establece los mensajes de detección de bloqueo que el host enviará a la sesión para detectar bloqueos.
SetHostIntranetInInternetExplorer	Establece si se van a abrir todos los sitios de intranet de la sesión.
SetHybridMode	Establece si se va a habilitar el control de listas de sitios del modo híbrido.
SetReverseCookieSync	Establece si los cambios de cookies se sincronizan de nuevo con el host.
SetSitePermissions	Establece los permisos de sitio para la sesión.
SetUseAdditionalHangDetection	Establece si se deben habilitar detecciones de bloqueo adicionales.
ShowDownloadWindow	Muestra la ventana de descarga de Internet Explorer.
SyncCookies	Envía datos de cookies al proceso de sesión.

Se aplica a

Producto	Agregado
Windows 10, versión 20H1	KB5032278
Windows 11, versión 22H2	KB5032288

Members

CloneActiveTabRecoveryData

Duplica los datos de recuperación de una pestaña activa.

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

Parameters

• hwndBrowser HWND de la ventana del explorador hospedado.

• guidSrcFile GUID del archivo de datos de recuperación de origen que se va a copiar.

• guidDestFile GUID que se va a asociar al nuevo archivo de datos de recuperación de pestañas.

CloneInactiveTabRecoveryData

Duplica los datos de recuperación de una pestaña inactiva.

public HRESULT CloneInactiveTabRecoveryData(REFGUID guidSrcFile, REFGUID guidDestFile)

Parameters

• guidSrcFile GUID del archivo de datos de recuperación de origen que se va a copiar.

• guidDestFile GUID que se va a asociar al nuevo archivo de datos de recuperación de pestañas.

CreateDualEngineBrowser

Crea un objeto Browser en esta sesión.

public HRESULT CreateDualEngineBrowser(IDualEngine20Browser ** ppDualEngineBrowser)

Parameters

• ppDualEngineBrowser Nuevo objeto Browser.

DeleteAllButRecoverableRecoveryFiles

Elimina todos los archivos de datos de recuperación de tabulación, excepto los proporcionados.

public HRESULT DeleteAllButRecoverableRecoveryFiles(int cRecoverableGUIDs, LPCWSTR * rgpszRecoverableGUIDs)

Parameters

• cRecoverableGUIDs Número de GUID en rgpszRecoverableGUIDs.

• rgpszRecoverableGUIDs Matriz de GUID que representan archivos de datos de recuperación de pestañas que no se van a eliminar.

DeleteInactiveRegionRecoveryData

Elimina los datos de recuperación de tabulación de una región inactiva.

public HRESULT DeleteInactiveRegionRecoveryData(REFGUID guidTabId)

Parameters

• guidTabId GUID de los datos de recuperación que se van a eliminar.

GetRequestedHostForwardedAccelerators

Devuelve una lista de aceleradores de teclado que se deben reenviar desde el host.

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

Parameters

• pcAccels Número de aceleradores en prgAccels.

• prgAccels Lista de aceleradores de teclado que se deben reenviar. Cuando termine, el autor de la llamada debe liberar la memoria asignada para la lista con CoTaskMemFree.

Initialize

Inicializa la sesión.

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

Parameters

• cAccels Número de aceleradores en rgHostPriorityAccels.

• rgHostPriorityAccels Lista de aceleradores de teclado para que la sesión se reenvíe al host.

• pSessionObserver Observador de eventos de esta sesión.

• pszProfilePath Ruta de acceso a la ruta de acceso del perfil del host donde la sesión almacenará los archivos pertinentes.

• pszProfileId Identificador de perfil del host que se va a asociar a esta sesión.

ParseEmieSitelist

Analiza el XML de lista de sitios en la ruta de acceso proporcionada.

public HRESULT ParseEmieSitelist(LPCWSTR emieXmlPath)

Parameters

• emieXmlPath Ruta de acceso al XML de lista de sitios que se va a analizar.

SetConfigurableSitesFlags

Establece marcas que determinan cómo se controlan los sitios configurables.

public HRESULT SetConfigurableSitesFlags(DualEngineConfigurableSitesFlags flags)

Parameters

• flags Marcas que indican cómo se controlan los sitios configurables.

SetHangDetectionMessages

Establece los mensajes de detección de bloqueo que el host enviará a la sesión para detectar bloqueos.

public HRESULT SetHangDetectionMessages(UINT uiSyncHungCheckMsg, UINT uiAsyncHungCheckMsg)

Parameters

• uiSyncHungCheckMsg El identificador de mensaje de ventana del mensaje en el que el host esperará sincrónicamente para controlarse.

• uiAsyncHungCheckMsg Identificador del mensaje de ventana del mensaje en el que el host esperará de forma asincrónica. Los exploradores indican al host llamando a IDualEngine20BrowserObserver::OnAsyncHungCheckReply().

SetHostIntranetInInternetExplorer

Establece si se van a abrir todos los sitios de intranet de la sesión.

public HRESULT SetHostIntranetInInternetExplorer(BOOL fEnable)

Parameters

• fEnable Si truees , la navegación a sitios de intranet permanecerá en la sesión; de lo contrario, si una navegación permanecerá en la sesión o no seguirá la lógica de determinación predeterminada.

SetHybridMode

Establece si se va a habilitar el control de listas de sitios del modo híbrido.

public HRESULT SetHybridMode(BOOL fEnable)

Parameters

• fEnable Si truees , el comportamiento del modo híbrido está habilitado al controlar las direcciones URL de lista de sitios; de lo contrario, se produce un comportamiento de navegación normal.

SetReverseCookieSync

Establece si los cambios de cookies se sincronizan de nuevo con el host.

public HRESULT SetReverseCookieSync(BOOL fEnable)

Parameters

• fEnable Si truees , el evento IDualEngine20BrowserSessionObserver::ReverseSyncCookies() notificará al host de los cambios de cookies; de lo contrario, no lo es.

SetSitePermissions

Establece los permisos de sitio para la sesión.

public HRESULT SetSitePermissions(SITE_PERMISSION_KIND sitePermissionKind, LPCWSTR pszPermissionData)

Parameters

• sitePermissionKind Tipo de permiso de sitio que se está estableciendo.

• pszPermissionData Cadena serializada de los datos de permiso que se van a establecer.

pszPermissionData es una cadena en el siguiente 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

Vea también:

• Apéndice A. Abnf recopilado para URI en RFC 3986 - Identificador uniforme de recursos (URI): sintaxis genérica.

SetUseAdditionalHangDetection

Establece si se deben habilitar detecciones de bloqueo adicionales.

public HRESULT SetUseAdditionalHangDetection(BOOL fEnable)

Parameters

• fEnable Si truees , se habilitarán las detecciones de bloqueo adicionales; de lo contrario, no lo harán.

ShowDownloadWindow

Muestra la ventana de descarga de Internet Explorer.

public HRESULT ShowDownloadWindow()

SyncCookies

Envía datos de cookies al proceso de sesión.

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

Parameters

• pCookies Matriz de cookies que se van a enviar a la sesión.

• cCookies Número de elementos de pCookies.