interfaz IDualEngine20BrowserObserver

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 el soporte técnico de Microsoft.

interface IDualEngine20BrowserObserver
  : public IUnknown

Recibe eventos del explorador.

Resumen

Members	Descripciones
ContinueNavigationInEdge	Se genera cuando el explorador quiere dejar de hospedar contenido y hacer que la navegación a la dirección URL continúe en el proceso de hospedaje.
ContinueNavigationInEdge2	Se genera cuando el explorador quiere dejar de hospedar contenido y hacer que la navegación a la dirección URL continúe en el proceso de hospedaje; esta versión proporciona información adicional sobre la navegación.
NavigateToOffsetInEdge	Se genera cuando el explorador solicita navegar a un desplazamiento de entrada del registro de viajes.
OnAllButCurrentEntryDeleted	Se genera cuando el explorador ha eliminado todas las entradas de su registro de viajes, excepto la entrada actual.
OnAsyncHungCheckReply	Cuando el explorador procesa un mensaje de comprobación de bloqueo asincrónico, vea IDualEngine20BrowserSession::SetHangDetectionMessages().
OnAttentionState	Se genera al solicitar atención al usuario.
OnBeforeUnloadAndStopComplete	Se genera cuando el evento beforeUnload ha terminado de procesarse.
OnCloseCompleted	Se genera cuando se cierra el explorador.
OnCloseRequested	Se genera cuando el explorador ha solicitado cerrar.
OnDialogShown	Se genera cuando un explorador muestra u oculta un cuadro de diálogo modal.
OnDocumentComplete	Se genera cuando un documento se carga e inicializa por completo.
OnDocumentModeSet	Se genera cuando el modo de documento ha cambiado.
OnEnterpriseIDSet	Se genera cuando se ha completado una navegación; proporciona información sobre el identificador de empresa.
OnFindOnPageResult	Se genera cuando la búsqueda en los resultados de la página cambia.
OnFinishedSetFocus	Se genera cuando una solicitud IDualEngine20Browser::D ualEngineSetFocus() ha terminado de procesarse.
OnGeolocationFeatureInUse	Se genera cuando se accede a los datos de geolocalización.
OnGeolocationPermissionRequested	Se genera cuando se necesita el permiso de usuario para habilitar la geolocalización.
OnHasBeforeUnloadChanged	Se genera cuando se ha registrado o quitado un OnBeforeUnload controlador.
OnIndicatorItemsSet	Se genera cuando se ha completado una navegación; proporciona información de estado sobre el estado actual de la página del explorador.
OnInputAt tentado	Se genera cuando se recibe la entrada del usuario.
OnLoadingActivityChanged	Se genera cuando cambia el estado de carga de la página.
OnMixedContentBlocked	Se genera cuando se ha bloqueado el contenido mixto.
OnNavigationComplete	Se genera cuando se ha completado una navegación.
OnNavigationFailed	Se genera cuando se produce un error en una navegación.
OnNavigationToDownload	Se genera cuando una navegación ha finalizado en una descarga.
OnNewWindow	Se genera cuando se ha creado una nueva ventana.
OnPopupBlocked	Se genera cuando se bloquea una ventana emergente.
OnPrepareToExitRegionFailed	Se genera cuando el explorador no ha podido controlar una llamada IDualEngine20Browser::D ualEnginePrepareToExitRegion().
OnReadyToExitRegion	Se genera cuando el explorador ha controlado correctamente una llamada IDualEngine20Browser::D ualEnginePrepareToExitRegion().
OnTabCrashed	Se genera cuando la pestaña se ha bloqueado.
OnTabHangReported	Se genera cuando se bloquea el explorador.
OnUnexpectedRundown	Se genera cuando el explorador se ha cerrado inesperadamente.
OnUnhandledKeyboardAccelerator	Se genera al procesar un acelerador de teclado y se determina que el explorador no controla ese acelerador o no debe basarse en rgHostPriorityAccelsél.
OnUnhandledKeyboardAcceleratorAsync	Se genera al procesar un acelerador de teclado y se determina que el explorador no controla ese acelerador o no debe basarse en rgHostPriorityAccelsél.
OnVisibleComplete	Se genera cuando el contenido de la página se hace visible.
OnZoomChanged	Se genera cuando el zoom ha cambiado.
OpenURLInEdge	Se genera cuando el explorador solicita al host que navegue a una dirección URL en una nueva ventana.
OpenURLInEdge2	Se genera cuando el explorador solicita al host que navegue a una dirección URL en una nueva ventana; esta versión proporciona información adicional sobre la navegación.
RequestHostAddFavorite	Se genera cuando se solicita que se agregue una página a favoritos.
RequestHostCreateUrlTip	Se genera al solicitar mostrar una información sobre herramientas que contiene una dirección URL.
RequestHostFocus	Se genera cuando se solicita que el foco se mueva a la ventana host.
RequestHostFullscreen	Se genera cuando la página solicita que el host muestre contenido en pantalla completa.
RequestHostHideUrlTip	Se genera al solicitar ocultar una información sobre herramientas que contiene una dirección URL.
RequestHostPositionChanged	Se genera cuando el explorador solicita que el host cambie su tamaño o posición.
RequestHostShowTheater	Se genera cuando el explorador solicita al host que entre o salga del modo de teatro.
RequestHostWindowFocus	Se genera cuando se solicita al host que tome o desasoye el foco.
RequestHostWindowFocusSync	Se genera cuando se solicita al host que tome o desasoye el foco.
UpdateHostFavicon	Se genera cuando el icono de favoritos ha cambiado.
UpdateHostTitle	Se genera cuando se ha actualizado el título de la página.
UpdateSecureLockIcon	Se genera cuando la información de seguridad de la página ha cambiado.

Se aplica a

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

Members

ContinueNavigationInEdge

Se genera cuando el explorador quiere dejar de hospedar contenido y hacer que la navegación a la dirección URL continúe en el proceso de hospedaje.

public HRESULT ContinueNavigationInEdge(LPCWSTR pszUrl, ULONG ulCookieSyncVersion)

Parameters

• pszUrl Dirección URL a la que se debe navegar.

• ulCookieSyncVersion Número que se puede usar para correlacionar una navegación con un estado de cookie específico.

ContinueNavigationInEdge2

Se genera cuando el explorador quiere dejar de hospedar contenido y hacer que la navegación a la dirección URL continúe en el proceso de hospedaje; esta versión proporciona información adicional sobre la navegación.

public HRESULT ContinueNavigationInEdge2(LPCWSTR pszUrl, ULONG ulCookieSyncVersion, LPCWSTR pszReferrer, LPCWSTR pszHeaders, VARIANT * postData)

Parameters

• pszUrl Dirección URL a la que se debe navegar.

• ulCookieSyncVersion Número que se puede usar para correlacionar una navegación con un estado de cookie específico.

• pszReferrer Encabezado de solicitud http referer.

• pszHeaders Encabezados HTTP adicionales.

• postData Datos HTTP POST, como datos de formulario.

NavigateToOffsetInEdge

Se genera cuando el explorador solicita navegar a un desplazamiento de entrada del registro de viajes.

public HRESULT NavigateToOffsetInEdge(int iOffset)

Parameters

• iOffset Desplazamiento al que se va a navegar.

OnAllButCurrentEntryDeleted

Se genera cuando el explorador ha eliminado todas las entradas de su registro de viajes, excepto la entrada actual.

public HRESULT OnAllButCurrentEntryDeleted(VisibleListUpdateEntry * pVisibleListEntries, int cVisibleListEntries)

Parameters

• pVisibleListEntries Lista que contiene las nuevas entradas del registro de viajes desde la última actualización. En este caso, solo tendrá la entrada activa actual.

• cVisibleListEntries El número de elementos de pVisibleListEntries

OnAsyncHungCheckReply

Cuando el explorador procesa un mensaje de comprobación de bloqueo asincrónico, vea IDualEngine20BrowserSession::SetHangDetectionMessages().

public HRESULT OnAsyncHungCheckReply(ULONG correlationId)

Parameters

• correlationId Identificador para correlacionar la respuesta con el mensaje enviado.

OnAttentionState

Se genera al solicitar atención al usuario.

public HRESULT OnAttentionState(ATTENTIONSTATE attentionState)

Parameters

• attentionState El motivo por el que se solicita atención al usuario.

OnBeforeUnloadAndStopComplete

Se genera cuando el evento beforeUnload ha terminado de procesarse.

public HRESULT OnBeforeUnloadAndStopComplete(BOOL agreeToClose)

Parameters

• agreeToClose Indica si el usuario ha aceptado salir de la página.

OnCloseCompleted

Se genera cuando se cierra el explorador.

public HRESULT OnCloseCompleted()

OnCloseRequested

Se genera cuando el explorador ha solicitado cerrar.

public HRESULT OnCloseRequested()

OnDialogShown

Se genera cuando un explorador muestra u oculta un cuadro de diálogo modal.

public HRESULT OnDialogShown(BOOL fShown)

Parameters

• fShown Indica si el cuadro de diálogo se ha mostrado u oculto.

OnDocumentComplete

Se genera cuando un documento se carga e inicializa por completo.

public HRESULT OnDocumentComplete(ULONG ulCurrentEntryId, VisibleListUpdateEntry * pVisibleListEntries, int cVisibleListEntries)

Parameters

• ulCurrentEntryId Identificador de entrada del registro de viajes de la página que generó este evento.

• pVisibleListEntries Lista que contiene las nuevas entradas del registro de viajes desde la última actualización.

• cVisibleListEntries El número de elementos de pVisibleListEntries

OnDocumentModeSet

Se genera cuando el modo de documento ha cambiado.

public HRESULT OnDocumentModeSet(ULONG documentMode)

Parameters

• documentMode La nueva versión del modo de documento.

OnEnterpriseIDSet

Se genera cuando se ha completado una navegación; proporciona información sobre el identificador de empresa.

public HRESULT OnEnterpriseIDSet(BOOL fEnterpriseID)

Parameters

• fEnterpriseID Indica si el explorador tiene un identificador de empresa establecido.

OnFindOnPageResult

Se genera cuando la búsqueda en los resultados de la página cambia.

public HRESULT OnFindOnPageResult(int iRequestID, int cMatches, int iActiveMatch)

Parameters

• iRequestIDIdentificador para correlacionar los resultados con las solicitudes IDualEngine20Browser::D ualEngineFindOnPage().

• cMatches Recuento de coincidencias.

• iActiveMatch Índice de la coincidencia seleccionada.

OnFinishedSetFocus

Se genera cuando una solicitud IDualEngine20Browser::D ualEngineSetFocus() ha terminado de procesarse.

public HRESULT OnFinishedSetFocus()

OnGeolocationFeatureInUse

Se genera cuando se accede a los datos de geolocalización.

public HRESULT OnGeolocationFeatureInUse(LPCWSTR pszContextUrl, SITE_PERMISSION_FEATURE_MODE featureMode)

Parameters

• pszContextUrl Dirección URL de la página que accede a los datos de geolocalización.

• featureMode Indica si el acceso se ha bloqueado o permitido.

OnGeolocationPermissionRequested

Se genera cuando se necesita el permiso de usuario para habilitar la geolocalización.

public HRESULT OnGeolocationPermissionRequested(LPCWSTR pszContextUrl)

Parameters

• pszContextUrl Dirección URL de la página que solicita el permiso de geolocalización.

OnHasBeforeUnloadChanged

Se genera cuando se ha registrado o quitado un OnBeforeUnload controlador.

public HRESULT OnHasBeforeUnloadChanged(BOOL fBeforeUnload)

Parameters

• fBeforeUnload true indica que se registró un OnBeforeUnload controlador; false indica que se quitó.

OnIndicatorItemsSet

Se genera cuando se ha completado una navegación; proporciona información de estado sobre el estado actual de la página del explorador.

public HRESULT OnIndicatorItemsSet(BOOL fProtectedMode, BOOL fEnhancedProtectedMode, DWORD dwUrlZone, BOOL fEnterpriseMode)

Parameters

• fProtectedMode Indica si el explorador está en modo protegido.

• fEnhancedProtectedMode Indica si el explorador está en modo protegido mejorado.

• dwUrlZone Zona de la dirección URL actual.

• fEnterpriseMode Indica si el explorador está en modo de empresa.

OnInputAt tentado

Se genera cuando se recibe la entrada del usuario.

public HRESULT OnInputAttempted()

OnLoadingActivityChanged

Se genera cuando cambia el estado de carga de la página.

public HRESULT OnLoadingActivityChanged(BOOL fLoading)

Parameters

• fLoading Indica si la página se está cargando o no.

OnMixedContentBlocked

Se genera cuando se ha bloqueado el contenido mixto.

public HRESULT OnMixedContentBlocked()

OnNavigationComplete

Se genera cuando se ha completado una navegación.

public HRESULT OnNavigationComplete(REFGUID guidTabId, ULONG ulCurrentEntryId, VisibleListUpdateEntry * pVisibleListEntries, int cVisibleListEntries, DWORD dwNavFlags, SECURELOCKICON secureLockIcon, DWORD dwSecurityFlags, CryptDataBlob * pDualEngineCertificates, int cCertificateChainBlobs)

Parameters

• guidTabId GUID de recuperación para la pestaña.

• ulCurrentEntryId Identificador que representa esta navegación en la lista de entradas visibles.

• pVisibleListEntries Lista que contiene las nuevas entradas del registro de viajes desde la última actualización.

• cVisibleListEntries Número de elementos de pVisibleListEntries.

• dwNavFlags Marcas que indican el tipo de navegación que se produjo.

• secureLockIcon Estado de seguridad de la página.

• dwSecurityFlags Marcas que indican los errores de certificado de la página.

• pDualEngineCertificates Lista que contiene la cadena de certificados de la página de la entrada actual.

• cCertificateChainBlobs Número de elementos de pDualEngineCertificates.

OnNavigationFailed

Se genera cuando se produce un error en una navegación.

public HRESULT OnNavigationFailed(NAVIGATIONFAILEDREASON failureReason)

Parameters

• failureReason Motivo por el que se produjo un error en la navegación.

OnNavigationToDownload

Se genera cuando una navegación ha finalizado en una descarga.

public HRESULT OnNavigationToDownload()

OnNewWindow

Se genera cuando se ha creado una nueva ventana.

public HRESULT OnNewWindow(IDualEngine20Browser * pNewBrowser, HWND hwnd, const DualEngineNewWindowOptions * options, IDualEngine20BrowserObserver ** ppObserver)

Parameters

• pNewBrowser Objeto del explorador de la nueva ventana.

• hwnd Identificador de la nueva ventana.

• options Opciones con las que se creó la nueva ventana.

• ppObserver Objeto de observador de la nueva ventana.

OnPopupBlocked

Se genera cuando se bloquea una ventana emergente.

public HRESULT OnPopupBlocked(LPCWSTR pszContextUrl, LPCWSTR pszPopupUrl)

Parameters

• pszContextUrl Dirección URL de la página que emitió el comando para abrir el elemento emergente.

• pszPopupUrl Dirección URL de la página emergente.

OnPrepareToExitRegionFailed

Se genera cuando el explorador no ha podido controlar una llamada IDualEngine20Browser::D ualEnginePrepareToExitRegion().

public HRESULT OnPrepareToExitRegionFailed()

OnReadyToExitRegion

Se genera cuando el explorador ha controlado correctamente una llamada IDualEngine20Browser::D ualEnginePrepareToExitRegion().

public HRESULT OnReadyToExitRegion(REFGUID guidClonedTabId, ULONG ulCurrentEntryId, VisibleListUpdateEntry * pVisibleListEntriesComplete, int cVisibleListEntriesComplete)

Parameters

• guidClonedTabId GUID del archivo de datos de recuperación de tabulación que respalda la región salida.

• ulCurrentEntryId Identificador de entrada del registro de viajes de la página que generó este evento.

• pVisibleListEntriesComplete Lista que contiene las nuevas entradas del registro de viajes desde la última actualización.

• cVisibleListEntriesComplete El número de elementos de pVisibleListEntriesComplete

OnTabCrashed

Se genera cuando la pestaña se ha bloqueado.

public HRESULT OnTabCrashed(BOOL fUnrecoverable)

Parameters

• fUnrecoverable Indica si la pestaña es recuperable.

OnTabHangReported

Se genera cuando se bloquea el explorador.

public HRESULT OnTabHangReported()

OnUnexpectedRundown

Se genera cuando el explorador se ha cerrado inesperadamente.

public HRESULT OnUnexpectedRundown()

OnUnhandledKeyboardAccelerator

Se genera al procesar un acelerador de teclado y se determina que el explorador no controla ese acelerador o no debe basarse en rgHostPriorityAccelsél.

public HRESULT OnUnhandledKeyboardAccelerator(LPMSG lpMsg)

Parameters

• lpMsg Mensaje win32 para el acelerador de teclado no controlado.

OnUnhandledKeyboardAcceleratorAsync

Se genera al procesar un acelerador de teclado y se determina que el explorador no controla ese acelerador o no debe basarse en rgHostPriorityAccelsél.

public HRESULT OnUnhandledKeyboardAcceleratorAsync(LPMSG pMsg, BOOL isShiftDown, BOOL isCtrlDown, BOOL isAltDown)

En esta versión del método, el evento se genera de forma asincrónica y el estado del teclado puede haber cambiado desde que se procesó, por lo que se proporciona el estado de las teclas modificadoras.

Parameters

• pMsg Mensaje win32 para el acelerador de teclado no controlado.

• isShiftDown Indica si se presionó la tecla Mayús .

• isCtrlDown Indica si se ha presionado la tecla Ctrl .

• isAltDown Indica si se ha presionado la tecla Alt .

OnVisibleComplete

Se genera cuando el contenido de la página se hace visible.

public HRESULT OnVisibleComplete()

OnZoomChanged

Se genera cuando el zoom ha cambiado.

public HRESULT OnZoomChanged(ULONG ulZoomPercent)

Parameters

• ulZoomPercent Nuevo porcentaje de zoom.

OpenURLInEdge

Se genera cuando el explorador solicita al host que navegue a una dirección URL en una nueva ventana.

public HRESULT OpenURLInEdge(LPCWSTR pszUrl, const DualEngineNewWindowOptions * options, ULONG ulCookieSyncVersion)

Parameters

• pszUrl Dirección URL a la que se va a navegar.

• options Opciones que se aplicarán a la nueva ventana.

• ulCookieSyncVersion Número que se puede usar para correlacionar una navegación con un estado de cookie específico.

OpenURLInEdge2

Se genera cuando el explorador solicita al host que navegue a una dirección URL en una nueva ventana; esta versión proporciona información adicional sobre la navegación.

public HRESULT OpenURLInEdge2(LPCWSTR pszUrl, const DualEngineNewWindowOptions * options, ULONG ulCookieSyncVersion, LPCWSTR pszReferrer, LPCWSTR pszHeaders, VARIANT * postData)

Parameters

• pszUrl Dirección URL a la que se va a navegar.

• options Opciones que se aplicarán a la navegación.

• ulCookieSyncVersion Número que se puede usar para correlacionar una navegación con un estado de cookie específico.

• pszReferrer Encabezado de solicitud http referer.

• pszHeaders Encabezados HTTP adicionales.

• postData Datos HTTP POST, como datos de formulario.

RequestHostAddFavorite

Se genera cuando se solicita que se agregue una página a favoritos.

public HRESULT RequestHostAddFavorite(LPCWSTR pszTitle, LPCWSTR pszUrl)

Parameters

• pszTitle Título de la página.

• pszUrl Dirección URL de la página.

RequestHostCreateUrlTip

Se genera al solicitar mostrar una información sobre herramientas que contiene una dirección URL.

public HRESULT RequestHostCreateUrlTip(LPCWSTR pszUrl)

Parameters

• pszUrl Dirección URL que se va a mostrar en la información sobre herramientas.

RequestHostFocus

Se genera cuando se solicita que el foco se mueva a la ventana host.

public HRESULT RequestHostFocus(DUALENGINE_FOCUSDIRECTION focusDirection, const MSG * msg)

Parameters

• focusDirection La dirección en la que se mueve el foco.

• msg Puntero al mensaje que provocó el cambio de foco.

RequestHostFullscreen

Se genera cuando la página solicita que el host muestre contenido en pantalla completa.

public HRESULT RequestHostFullscreen(FULLSCREENACTION fullScreenAction)

Parameters

• fullScreenAction Acción de pantalla completa que se solicita.

RequestHostHideUrlTip

Se genera al solicitar ocultar una información sobre herramientas que contiene una dirección URL.

public HRESULT RequestHostHideUrlTip()

RequestHostPositionChanged

Se genera cuando el explorador solicita que el host cambie su tamaño o posición.

public HRESULT RequestHostPositionChanged(LONG nX, LONG nY, LONG nWidth, LONG nHeight, ULONGLONG hSyncEvent)

Parameters

• nX Posición X de la ventana solicitada.

• nY La posición Y de la ventana solicitada.

• nWidth Ancho de ventana solicitado.

• nHeight Alto de ventana solicitado.

• hSyncEvent Identificador del objeto de evento que debe indicarse cuando se complete el cambio.

RequestHostShowTheater

Se genera cuando el explorador solicita al host que entre o salga del modo de teatro.

public HRESULT RequestHostShowTheater(BOOL fShow)

Parameters

• fShow Si truees , se solicita al host que entre en modo de teatro; si falsees , se le solicita que salga del modo de teatro.

RequestHostWindowFocus

Se genera cuando se solicita al host que tome o desasoye el foco.

public HRESULT RequestHostWindowFocus(BOOL fFocus)

Parameters

• fFocus Indica lo que se debe hacer con el foco. Si truees , se debe tomar el foco; de lo contrario, debe cederse.

RequestHostWindowFocusSync

Se genera cuando se solicita al host que tome o desasoye el foco.

public HRESULT RequestHostWindowFocusSync(BOOL fFocus, ULONGLONG hSyncEvent)

En esta versión del método, el explorador esperará hasta que se señale el evento proporcionado.

Parameters

• fFocus Indica lo que se debe hacer con el foco. Si truees , se debe tomar el foco; de lo contrario, debe cederse.

• hSyncEvent Identificador del objeto de evento que debe indicarse cuando se complete el cambio.

UpdateHostFavicon

Se genera cuando el icono de favoritos ha cambiado.

public HRESULT UpdateHostFavicon(ULONG ulCurrentEntryId, LPCWSTR spszCurrentUrl, LPCWSTR * pIconUrls, int cIconUrls)

Parameters

• ulCurrentEntryId Identificador de entrada del registro de viajes de la página que generó este evento.

• spszCurrentUrl Dirección URL de la página.

• pIconUrls Una lista de direcciones URL de icono de favoritos.

• cIconUrls Número de elementos de pIconUrls.

UpdateHostTitle

Se genera cuando se ha actualizado el título de la página.

public HRESULT UpdateHostTitle(ULONG ulCurrentEntryId, LPCWSTR pszTitle)

Parameters

• ulCurrentEntryId Identificador de la página de la lista de entradas visibles que generó este evento.

• pszTitle Nuevo título.

UpdateSecureLockIcon

Se genera cuando la información de seguridad de la página ha cambiado.

public HRESULT UpdateSecureLockIcon(ULONG ulCurrentEntryId, SECURELOCKICON secureLockIcon)

Parameters

• ulCurrentEntryId Entrada del registro de viaje para este cambio.

• secureLockIcon Estado de la información de seguridad.