Freigeben über

Schnittstelle IDualEngine20BrowserSession

  • Artikel

Wichtig

Die DualEngine-API ist Teil eines Features mit eingeschränktem Zugriff (siehe LimitedAccessFeatures-Klasse). Wenn Sie weitere Informationen oder ein Entsperrtoken anfordern möchten, wenden Sie sich an Microsoft-Support.

interface IDualEngine20BrowserSession
  : public IUnknown

Stellt eine Internet Explorer Prozesssitzung dar.

Zusammenfassung

Members Beschreibungen
CloneActiveTabRecoveryData Dupliziert die Wiederherstellungsdaten einer aktiven Registerkarte.
CloneInactiveTabRecoveryData Dupliziert die Wiederherstellungsdaten einer inaktiven Registerkarte.
CreateDualEngineBrowser Erstellt in dieser Sitzung ein Browser-Objekt.
DeleteAllButRecoverableRecoveryFiles Löscht alle Wiederherstellungsdatendateien bis auf die bereitgestellte Registerkarte.
DeleteInactiveRegionRecoveryData Löscht die Registerkarten-Wiederherstellungsdaten einer inaktiven Region.
GetRequestedHostForwardedAccelerators Gibt eine Liste von Tastenkombinationen zurück, die vom Host weitergeleitet werden sollen.
Initialize Initialisiert die Sitzung.
ParseEmieSitelist Analysiert die Sitelist-XML am angegebenen Pfad.
SetConfigurableSitesFlags Legt Flags fest, die bestimmen, wie konfigurierbare Websites behandelt werden.
SetHangDetectionMessages Legt Meldungen zur Erkennung von Hängen fest, die vom Host an die Sitzung gesendet werden, um Hänger zu erkennen.
SetHostIntranetInInternetExplorer Legt fest, ob alle Intranetwebsites in der Sitzung geöffnet werden sollen.
SetHybridMode Legt fest, ob die Behandlung von Websitelisten im Hybridmodus aktiviert werden soll.
SetReverseCookieSync Legt fest, ob Cookieänderungen wieder mit dem Host synchronisiert werden.
SetSitePermissions Legt Websiteberechtigungen für die Sitzung fest.
SetUseAdditionalHangDetection Legt fest, ob zusätzliche Hängenderkennungen aktiviert werden sollen.
ShowDownloadWindow Zeigt das Downloadfenster "Internet Explorer" an.
SyncCookies Sendet Cookiedaten an den Sitzungsprozess.

Gilt für

Produkt Eingeführt
Windows 10, Version 20H1 KB5032278
Windows 11, Version 22H2 KB5032288

Members

CloneActiveTabRecoveryData

Dupliziert die Wiederherstellungsdaten einer aktiven Registerkarte.

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

Parameter

  • hwndBrowser Der HWND des gehosteten Browserfensters.

  • guidSrcFile Die GUID für die zu kopierende Quellwiederherstellungsdatendatei.

  • guidDestFile Die GUID, die der neuen Wiederherstellungsdatendatei auf der Registerkarte zugeordnet werden soll.

CloneInactiveTabRecoveryData

Dupliziert die Wiederherstellungsdaten einer inaktiven Registerkarte.

public HRESULT CloneInactiveTabRecoveryData(REFGUID guidSrcFile, REFGUID guidDestFile)

Parameter

  • guidSrcFile Die GUID für die zu kopierende Quellwiederherstellungsdatendatei.

  • guidDestFile Die GUID, die der neuen Wiederherstellungsdatendatei auf der Registerkarte zugeordnet werden soll.

CreateDualEngineBrowser

Erstellt in dieser Sitzung ein Browser-Objekt.

public HRESULT CreateDualEngineBrowser(IDualEngine20Browser ** ppDualEngineBrowser)

Parameter
  • ppDualEngineBrowser Das neue Browser-Objekt.

DeleteAllButRecoverableRecoveryFiles

Löscht alle Wiederherstellungsdatendateien bis auf die bereitgestellte Registerkarte.

public HRESULT DeleteAllButRecoverableRecoveryFiles(int cRecoverableGUIDs, LPCWSTR * rgpszRecoverableGUIDs)

Parameter

  • cRecoverableGUIDs Die Anzahl der GUIDs in rgpszRecoverableGUIDs.

  • rgpszRecoverableGUIDs Ein Array von GUIDs, die Tabstopp-Wiederherstellungsdatendateien darstellen, die nicht gelöscht werden sollen.

DeleteInactiveRegionRecoveryData

Löscht die Registerkarten-Wiederherstellungsdaten einer inaktiven Region.

public HRESULT DeleteInactiveRegionRecoveryData(REFGUID guidTabId)

Parameter
  • guidTabId Die GUID der zu löschenden Wiederherstellungsdaten.

GetRequestedHostForwardedAccelerators

Gibt eine Liste von Tastenkombinationen zurück, die vom Host weitergeleitet werden sollen.

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

Parameter

  • pcAccels Die Anzahl der Zugriffstasten in prgAccels.

  • prgAccels Eine Liste der Tastenkombinationen, die weitergeleitet werden sollen. Nach Abschluss des Vorgangs muss der Aufrufer den für die Liste zugewiesenen Speicher mit CoTaskMemFreefreigeben.

Initialize

Initialisiert die Sitzung.

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

Parameter

  • cAccels Die Anzahl der Zugriffstasten in rgHostPriorityAccels.

  • rgHostPriorityAccels Eine Liste der Tastenkombinationen, mit denen die Sitzung an den Host weitergeleitet wird.

  • pSessionObserver Ein Beobachter für Ereignisse aus dieser Sitzung.

  • pszProfilePath Der Pfad zum Profilpfad des Hosts, in dem die Sitzung relevante Dateien speichert.

  • pszProfileId Die Profil-ID des Hosts, die dieser Sitzung zugeordnet werden soll.

ParseEmieSitelist

Analysiert die Sitelist-XML am angegebenen Pfad.

public HRESULT ParseEmieSitelist(LPCWSTR emieXmlPath)

Parameter
  • emieXmlPath Pfad zur zu analysierenden Sitelist-XML.

SetConfigurableSitesFlags

Legt Flags fest, die bestimmen, wie konfigurierbare Websites behandelt werden.

public HRESULT SetConfigurableSitesFlags(DualEngineConfigurableSitesFlags flags)

Parameter
  • flags Die Flags, die angeben, wie konfigurierbare Websites behandelt werden.

SetHangDetectionMessages

Legt Meldungen zur Erkennung von Hängen fest, die vom Host an die Sitzung gesendet werden, um Hänger zu erkennen.

public HRESULT SetHangDetectionMessages(UINT uiSyncHungCheckMsg, UINT uiAsyncHungCheckMsg)

Parameter

SetHostIntranetInInternetExplorer

Legt fest, ob alle Intranetwebsites in der Sitzung geöffnet werden sollen.

public HRESULT SetHostIntranetInInternetExplorer(BOOL fEnable)

Parameter
  • fEnable Wenn true, bleibt die Navigation zu Intranetwebsites in der Sitzung erhalten. Andernfalls wird festgelegt, ob eine Navigation in der Sitzung verbleibt oder nicht der Standardermittlungslogik folgt.

SetHybridMode

Legt fest, ob die Behandlung von Websitelisten im Hybridmodus aktiviert werden soll.

public HRESULT SetHybridMode(BOOL fEnable)

Parameter
  • fEnable Gibt truean, ist das Verhalten im Hybridmodus bei der Verarbeitung von Websitelisten-URLs aktiviert, andernfalls tritt ein normales Navigationsverhalten auf.

SetReverseCookieSync

Legt fest, ob Cookieänderungen wieder mit dem Host synchronisiert werden.

public HRESULT SetReverseCookieSync(BOOL fEnable)

Parameter

SetSitePermissions

Legt Websiteberechtigungen für die Sitzung fest.

public HRESULT SetSitePermissions(SITE_PERMISSION_KIND sitePermissionKind, LPCWSTR pszPermissionData)

Parameter

  • sitePermissionKind Der Typ der Websiteberechtigung, die festgelegt wird.

  • pszPermissionData Eine serialisierte Zeichenfolge der festzulegenden Berechtigungsdaten.

pszPermissionData ist eine Zeichenfolge im folgenden BNF-Format:

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

Siehe auch:

SetUseAdditionalHangDetection

Legt fest, ob zusätzliche Hängenderkennungen aktiviert werden sollen.

public HRESULT SetUseAdditionalHangDetection(BOOL fEnable)

Parameter
  • fEnable Wenn true, werden zusätzliche Aufhängererkennungen aktiviert, andernfalls nicht.

ShowDownloadWindow

Zeigt das Downloadfenster "Internet Explorer" an.

public HRESULT ShowDownloadWindow()

SyncCookies

Sendet Cookiedaten an den Sitzungsprozess.

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

Parameter

  • pCookies Ein Array von Cookies, die an die Sitzung gesendet werden sollen.

  • cCookies Die Anzahl der Elemente in pCookies.