CoreWebView2ProcessFailedEventArgs Class
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.