Core - Add Cef.GetErrorCode

- Get the error code for when Cef.Initialize fails

Resolves #4914

Author: amaitland

CefSharp.Core.Runtime.RefAssembly/CefSharp.Core.Runtime.netcore.cs

@@ -69,6 +69,7 @@ public static void AddDisposable(System.IDisposable item) { }
         public static void DoMessageLoopWork() { }
         public static void EnableWaitForBrowsersToClose() { }
         public static int ExecuteProcess() { throw null; }
+        public static CefSharp.Enums.ResultCode GetExitCode() { throw null; }
         public static CefSharp.ICookieManager GetGlobalCookieManager() { throw null; }
         public static CefSharp.ICookieManager GetGlobalCookieManager(CefSharp.ICompletionCallback callback) { throw null; }
         public static CefSharp.IRequestContext GetGlobalRequestContext() { throw null; }

CefSharp.Core.Runtime/Cef.h

@@ -523,6 +523,19 @@ namespace CefSharp
                 return nullptr;
             }
 
+            /// <summary>
+            /// This function can optionally be called on the main application thread after
+            /// CefInitialize to retrieve the initialization exit code. When CefInitialize
+            /// returns true the exit code will be 0 (ResultCode.NormalExit).
+            /// Otherwise, see ResultCode for possible exit code values including
+            /// browser process initialization errors and normal early exit conditions
+            /// (such as ResultCode.NormalExitProcessNotified  for process singleton relaunch behavior).
+            /// </summary>
+            static ResultCode GetExitCode()
+            {
+                return (ResultCode)CefGetExitCode();
+            }
+
             /// <summary>
             /// Called prior to calling Cef.Shutdown, this diposes of any remaning
             /// ChromiumWebBrowser instances. In WPF this is used from Dispatcher.ShutdownStarted

CefSharp.Core/Cef.cs

@@ -6,6 +6,7 @@
 
 using System;
 using System.Threading.Tasks;
+using CefSharp.Enums;
 using CefSharp.Internals;
 
 namespace CefSharp
@@ -370,6 +371,19 @@ public static ICookieManager GetGlobalCookieManager(ICompletionCallback callback
             return Core.Cef.GetGlobalCookieManager(callback);
         }
 
+        /// <summary>
+        /// This function can optionally be called on the main application thread after
+        /// CefInitialize to retrieve the initialization exit code. When CefInitialize
+        /// returns true the exit code will be 0 (<see cref="ResultCode.NormalExit"/>).
+        /// Otherwise, see <see cref="ResultCode"/> for possible exit code values including
+        /// browser process initialization errors and normal early exit conditions
+        /// (such as <see cref="ResultCode.NormalExitProcessNotified"/>  for process singleton relaunch behavior).
+        /// </summary>
+        public static ResultCode GetExitCode()
+        {
+            return Core.Cef.GetExitCode();
+        }
+
         /// <summary>
         /// Called prior to calling Cef.Shutdown, this disposes of any remaining
         /// ChromiumWebBrowser instances. In WPF this is used from Dispatcher.ShutdownStarted

CefSharp/Enums/ResultCode.cs

@@ -0,0 +1,139 @@
+namespace CefSharp.Enums
+{
+    /// <summary>
+    /// CEF Exit Codes
+    /// </summary>
+    public enum ResultCode
+    {
+        // The following values should be kept in sync with Chromium's
+        // content::ResultCode type.
+
+        NormalExit,
+
+        /// <summary>
+        /// Process was killed by user or system.
+        /// </summary>
+        Killed,
+
+        /// <summary>
+        /// Process hung.
+        /// </summary>
+        Hung,
+
+        /// <summary>
+        /// A bad message caused the process termination.
+        /// </summary>
+        KilledBadMessage,
+
+        /// <summary>
+        /// The GPU process exited because initialization failed.
+        /// </summary>
+        GpuDeadOnArrival,
+
+        // The following values should be kept in sync with Chromium's
+        // chrome::ResultCode type. Unused chrome values are excluded.
+
+        ChromeFirst,
+
+        /// <summary>
+        /// A critical chrome file is missing.
+        /// </summary>
+        MissingData = 7,
+
+        /// <summary>
+        /// Command line parameter is not supported.
+        /// </summary>
+        UnsupportedParam = 13,
+
+        /// <summary>
+        /// The profile was in use on another host.
+        /// </summary>
+        ProfileInUse = 21,
+
+        /// <summary>
+        /// Failed to pack an extension via the command line.
+        /// </summary>
+        PackExtensionError = 22,
+
+        /// <summary>
+        /// The browser process exited early by passing the command line to another
+        /// running browser.
+        /// </summary>
+        NormalExitProcessNotified = 24,
+
+        /// <summary>
+        /// A browser process was sandboxed. This should never happen.
+        /// </summary>
+        InvalidSandboxState = 31,
+
+        /// <summary>
+        /// Cloud policy enrollment failed or was given up by user.
+        /// </summary>
+        CloudPolicyEnrollmentFailed = 32,
+
+        /// <summary>
+        /// The GPU process was terminated due to context lost.
+        /// </summary>
+        GpuExitOnContextLost = 34,
+
+        /// <summary>
+        /// An early startup command was executed and the browser must exit.
+        /// </summary>
+        NormalExitPackExtensionSuccess = 36,
+
+        /// <summary>
+        /// The browser process exited because system resources are exhausted. The
+        /// system state can't be recovered and will be unstable.
+        /// </summary>
+        SystemResourceExhausted = 37,
+
+        ChromeLast = 39,
+
+        // The following values should be kept in sync with Chromium's
+        // sandbox::TerminationCodes type.
+
+        SandboxFatalFirst = 7006,
+
+        /// <summary>
+        /// Windows sandbox could not set the integrity level.
+        /// </summary>
+        SandboxFatalIntegrity = SandboxFatalFirst,
+
+        /// <summary>
+        /// Windows sandbox could not lower the token.
+        /// </summary>
+        SandboxFatalDroptoken,
+
+        /// <summary>
+        /// Windows sandbox failed to flush registry handles.
+        /// </summary>
+        SandboxFatalFlushandles,
+
+        /// <summary>
+        /// Windows sandbox failed to forbid HCKU caching.
+        /// </summary>
+        SandboxFatalCachedisable,
+
+        /// <summary>
+        /// Windows sandbox failed to close pending handles.
+        /// </summary>
+        SandboxFatalClosehandles,
+
+        /// <summary>
+        /// Windows sandbox could not set the mitigation policy.
+        /// </summary>
+        SandboxFatalMitigation,
+
+        /// <summary>
+        /// Windows sandbox exceeded the job memory limit.
+        /// </summary>
+        SandboxFatalMemoryExceeded,
+
+        /// <summary>
+        /// Windows sandbox failed to warmup.
+        /// </summary>
+        SandboxFatalWarmup,
+
+        SandboxFatalLast,
+    }
+}