interface ICoreWebView2ProcessFailedEventArgs2

Note

This reference is no longer being maintained. For the latest API reference, see WebView2 API Reference.

interface ICoreWebView2ProcessFailedEventArgs2
  : public ICoreWebView2ProcessFailedEventArgs

A continuation of the ICoreWebView2ProcessFailedEventArgs interface.

Summary

Members Descriptions
get_ExitCode The exit code of the failing process, for telemetry purposes.
get_FrameInfosForFailedProcess The collection of FrameInfos for frames in the ICoreWebView2 that were being rendered by the failed process.
get_ProcessDescription Description of the process assigned by the WebView2 Runtime.
get_Reason The reason for the process failure.

Applies to

Product Introduced
WebView2 Win32 1.0.818.41
WebView2 Win32 Prerelease 1.0.824

Members

get_ExitCode

The exit code of the failing process, for telemetry purposes.

public HRESULT get_ExitCode(int * exitCode)

The exit code is always STILL_ACTIVE (259) when ProcessFailedKind is COREWEBVIEW2_PROCESS_FAILED_KIND_RENDER_PROCESS_UNRESPONSIVE.

get_FrameInfosForFailedProcess

The collection of FrameInfos for frames in the ICoreWebView2 that were being rendered by the failed process.

public HRESULT get_FrameInfosForFailedProcess(ICoreWebView2FrameInfoCollection ** frames)

The content in these frames is replaced with an error page. This is only available when ProcessFailedKind is COREWEBVIEW2_PROCESS_FAILED_KIND_FRAME_RENDER_PROCESS_EXITED; frames is null 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 COREWEBVIEW2_PROCESS_FAILED_KIND_RENDER_PROCESS_EXITED.

get_ProcessDescription

Description of the process assigned by the WebView2 Runtime.

public HRESULT get_ProcessDescription(LPWSTR * processDescription)

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 processDescription is empty if the WebView2 Runtime did not assign a description to the process.

The caller must free the returned string with CoTaskMemFree. See API Conventions.

get_Reason

The reason for the process failure.

public HRESULT get_Reason(COREWEBVIEW2_PROCESS_FAILED_REASON * reason)

Some of the reasons are only applicable to specific values of ICoreWebView2ProcessFailedEventArgs::ProcessFailedKind, and the following ProcessFailedKind values always return the indicated reason value:

ProcessFailedKind Reason
COREWEBVIEW2_PROCESS_FAILED_KIND_BROWSER_PROCESS_EXITED COREWEBVIEW2_PROCESS_FAILED_REASON_UNEXPECTED
COREWEBVIEW2_PROCESS_FAILED_KIND_RENDER_PROCESS_UNRESPONSIVE COREWEBVIEW2_PROCESS_FAILED_REASON_UNRESPONSIVE

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