Partage via

interface IDualEngine20BrowserSession

  • Article

Importante

L’API DualEngine fait partie d’une fonctionnalité d’accès limité (voir classe LimitedAccessFeatures). Pour plus d’informations ou pour demander un jeton de déverrouillage, contactez Support Microsoft.

interface IDualEngine20BrowserSession
  : public IUnknown

Représente une session de processus Internet Explorer.

Résumé

Members Descriptions
CloneActiveTabRecoveryData Duplique les données de récupération d’un onglet actif.
CloneInactiveTabRecoveryData Duplique les données de récupération d’un onglet inactif.
CreateDualEngineBrowser Crée un objet Browser dans cette session.
DeleteAllButRecoverableRecoveryFiles Supprime tous les fichiers de données de récupération de l’onglet fournis, sauf ceux fournis.
DeleteInactiveRegionRecoveryData Supprime les données de récupération d’onglet d’une région inactive.
GetRequestedHostForwardedAccelerators Retourne une liste d’accélérateurs clavier qui doivent être transférés à partir de l’hôte.
Initialize Initialise la session.
ParseEmieSitelist Analyse le code XML de liste de sites au niveau du chemin d’accès fourni.
SetConfigurableSitesFlags Définit des indicateurs qui déterminent la façon dont les sites configurables sont gérés.
SetHangDetectionMessages Définit les messages de détection de blocage qui seront envoyés à la session par l’hôte pour détecter les blocages.
SetHostIntranetInInternetExplorer Définit s’il faut ouvrir tous les sites intranet dans la session.
SetHybridMode Définit s’il faut activer la gestion des listes de sites en mode hybride.
SetReverseCookieSync Définit si les modifications apportées aux cookies sont synchronisées avec l’hôte.
SetSitePermissions Définit les autorisations de site pour la session.
SetUseAdditionalHangDetection Définit s’il faut activer des détections de blocage supplémentaires.
ShowDownloadWindow Affiche la fenêtre de téléchargement d’Internet Explorer.
SyncCookies Envoie des données de cookie au processus de session.

S’applique à

Produit Introduit
Windows 10, version 20H1 KB5032278
Windows 11, version 22H2 KB5032288

Members

CloneActiveTabRecoveryData

Duplique les données de récupération d’un onglet actif.

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

Paramètres

  • hwndBrowser HWND de la fenêtre du navigateur hébergé.

  • guidSrcFile GUID du fichier de données de récupération source à copier.

  • guidDestFile GUID à associer au nouveau fichier de données de récupération d’onglet.

CloneInactiveTabRecoveryData

Duplique les données de récupération d’un onglet inactif.

public HRESULT CloneInactiveTabRecoveryData(REFGUID guidSrcFile, REFGUID guidDestFile)

Paramètres

  • guidSrcFile GUID du fichier de données de récupération source à copier.

  • guidDestFile GUID à associer au nouveau fichier de données de récupération d’onglet.

CreateDualEngineBrowser

Crée un objet Browser dans cette session.

public HRESULT CreateDualEngineBrowser(IDualEngine20Browser ** ppDualEngineBrowser)

Paramètres
  • ppDualEngineBrowser Nouvel objet Browser.

DeleteAllButRecoverableRecoveryFiles

Supprime tous les fichiers de données de récupération de l’onglet fournis, sauf ceux fournis.

public HRESULT DeleteAllButRecoverableRecoveryFiles(int cRecoverableGUIDs, LPCWSTR * rgpszRecoverableGUIDs)

Paramètres

  • cRecoverableGUIDs Nombre de GUID dans rgpszRecoverableGUIDs.

  • rgpszRecoverableGUIDs Tableau de GUID représentant les fichiers de données de récupération d’onglet qui ne doivent pas être supprimés.

DeleteInactiveRegionRecoveryData

Supprime les données de récupération d’onglet d’une région inactive.

public HRESULT DeleteInactiveRegionRecoveryData(REFGUID guidTabId)

Paramètres
  • guidTabId GUID des données de récupération à supprimer.

GetRequestedHostForwardedAccelerators

Retourne une liste d’accélérateurs clavier qui doivent être transférés à partir de l’hôte.

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

Paramètres

  • pcAccels Nombre d’accélérateurs dans prgAccels.

  • prgAccels Liste des accélérateurs clavier qui doivent être transférés. Lorsque vous avez terminé, l’appelant doit libérer la mémoire allouée pour la liste avec CoTaskMemFree.

Initialize

Initialise la session.

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

Paramètres

  • cAccels Nombre d’accélérateurs dans rgHostPriorityAccels.

  • rgHostPriorityAccels Liste des accélérateurs clavier pour que la session soit transférée à l’hôte.

  • pSessionObserver Observateur des événements de cette session.

  • pszProfilePath Chemin d’accès au profil de l’hôte où la session stockera les fichiers pertinents.

  • pszProfileId ID de profil de l’hôte à associer à cette session.

ParseEmieSitelist

Analyse le code XML de liste de sites au niveau du chemin d’accès fourni.

public HRESULT ParseEmieSitelist(LPCWSTR emieXmlPath)

Paramètres
  • emieXmlPath Chemin d’accès au xml de liste de sites à analyser.

SetConfigurableSitesFlags

Définit des indicateurs qui déterminent la façon dont les sites configurables sont gérés.

public HRESULT SetConfigurableSitesFlags(Indicateurs DualEngineConfigurableSitesFlags)

Paramètres
  • flags Indicateurs indiquant comment les sites configurables sont gérés.

SetHangDetectionMessages

Définit les messages de détection de blocage qui seront envoyés à la session par l’hôte pour détecter les blocages.

public HRESULT SetHangDetectionMessages(UINT uiSyncHungCheckMsg, UINT uiAsyncHungCheckMsg)

Paramètres

  • uiSyncHungCheckMsg ID de message de fenêtre du message que l’hôte attend de façon synchrone pour être géré.

  • uiAsyncHungCheckMsg ID de message de fenêtre du message que l’hôte attend de façon asynchrone. Les navigateurs signalent l’hôte en appelant IDualEngine20BrowserObserver ::OnAsyncHungCheckReply().

SetHostIntranetInInternetExplorer

Définit s’il faut ouvrir tous les sites intranet dans la session.

public HRESULT SetHostIntranetInInternetExplorer(BOOL fEnable)

Paramètres
  • fEnable Si truela valeur est , la navigation vers les sites intranet reste dans la session ; sinon, si une navigation reste dans la session ou non, suit la logique de détermination par défaut.

SetHybridMode

Définit s’il faut activer la gestion des listes de sites en mode hybride.

public HRESULT SetHybridMode(BOOL fEnable)

Paramètres
  • fEnable Si truela valeur est , le comportement en mode hybride est activé lors de la gestion des URL de liste de sites ; sinon, un comportement de navigation normal se produit.

SetReverseCookieSync

Définit si les modifications apportées aux cookies sont synchronisées avec l’hôte.

public HRESULT SetReverseCookieSync(BOOL fEnable)

Paramètres

SetSitePermissions

Définit les autorisations de site pour la session.

public HRESULT SetSitePermissions(SITE_PERMISSION_KIND sitePermissionKind, LPCWSTR pszPermissionData)

Paramètres

  • sitePermissionKind Type d’autorisation de site en cours de définition.

  • pszPermissionData Chaîne sérialisée des données d’autorisation à définir.

pszPermissionData est une chaîne au format BNF suivant :

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

Voir aussi :

SetUseAdditionalHangDetection

Définit s’il faut activer des détections de blocage supplémentaires.

public HRESULT SetUseAdditionalHangDetection(BOOL fEnable)

Paramètres
  • fEnable Si truela valeur est , les détections de blocage supplémentaires sont activées ; sinon, elles ne le seront pas.

ShowDownloadWindow

Affiche la fenêtre de téléchargement d’Internet Explorer.

public HRESULT ShowDownloadWindow()

SyncCookies

Envoie des données de cookie au processus de session.

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

Paramètres

  • pCookies Tableau de cookies à envoyer à la session.

  • cCookies Nombre d’éléments dans pCookies.