CoreWebView2ProcessFailedEventArgs Class

  • Article

Event args for the CoreWebView2.ProcessFailed event.

Summary

Members Description
ExitCode Gets the exit code of the failing process, for telemetry purposes.
FailureSourceModulePath When ProcessFailed occurred due to a failed Code Integrity check, this property returns the full path of the file that was prevented from loading on the system.
FrameInfosForFailedProcess Gets the collection of CoreWebView2FrameInfos for frames in the CoreWebView2 that were being rendered by the failed process.
ProcessDescription Gets a description of the failing process, assigned by the WebView2 Runtime.
ProcessFailedKind Gets the kind of process failure that has occurred.
Reason Gets the reason for the process failure.

Properties

ExitCode

readonly int ExitCode

Gets the exit code of the failing process, for telemetry purposes. The exit code is always STILL_ACTIVE(259) when CoreWebView2ProcessFailedEventArgs.ProcessFailedKind is CoreWebView2ProcessFailedKind.RenderProcessUnresponsive.

FailureSourceModulePath

readonly string FailureSourceModulePath

When ProcessFailed occurred due to a failed Code Integrity check, this property returns the full path of the file that was prevented from loading on the system. The webview2 process which tried to load the DLL will fail with exit code STATUS_INVALID_IMAGE_HASH(-1073740760).

FrameInfosForFailedProcess

readonly IVectorView<CoreWebView2FrameInfo> FrameInfosForFailedProcess

Gets the collection of CoreWebView2FrameInfos for frames in the CoreWebView2 that were being rendered by the failed process. This is only available when CoreWebView2ProcessFailedEventArgs.ProcessFailedKind is CoreWebView2ProcessFailedKind.FrameRenderProcessExited; the returned collection is empty for all other process failure kinds, including the case in which the failed process was the renderer for the main frame and subframes within it, for which the failure kind is CoreWebView2ProcessFailedKind.RenderProcessExited.

ProcessDescription

readonly string ProcessDescription

Gets a description of the failing process, assigned by the WebView2 Runtime. This is a technical English term appropriate for logging or development purposes, and not localized for the end user. It applies to utility processes (for example, "Audio Service", "Video Capture") and plugin processes (for example, "Flash"). The returned string is empty if the WebView2 Runtime did not assign a description to the process.

ProcessFailedKind

readonly CoreWebView2ProcessFailedKind ProcessFailedKind

Gets the kind of process failure that has occurred. ProcessFailedKind is a combination of process kind (for example, browser, renderer, gpu) and failure (exit, unresponsiveness). Renderer processes are further divided in main frame renderer (RenderProcessExited, RenderProcessUnresponsive) and subframe renderer (FrameRenderProcessExited). To learn about the conditions under which each failure kind occurs, see CoreWebView2ProcessFailedKind.

Reason

readonly CoreWebView2ProcessFailedReason Reason

Gets the reason for the process failure. Some of the reasons are only applicable to specific values of CoreWebView2ProcessFailedEventArgs.ProcessFailedKind, and the following CoreWebView2ProcessFailedEventArgs.ProcessFailedKind values always return the indicated reason value:

ProcessFailedKind Reason
BrowserProcessExited Unexpected
RenderProcessUnresponsive Unresponsive

For other CoreWebView2ProcessFailedEventArgs.ProcessFailedKind values, the reason may be any of the reason values. To learn about what these values mean, see CoreWebView2ProcessFailedReason.

Referenced by