Added an overloaded versions of the StartRegularProcess() and StartEl…

…evatedProcess() public methods with command-line arguments support.
xvitaly · Apr 22, 2024 · 55b83e5 · 55b83e5
1 parent 7a056f3
commit 55b83e5
Show file tree

Hide file tree

Showing 5 changed files with 97 additions and 53 deletions.
diff --git a/src/mhlib/CurrentPlatform.cs b/src/mhlib/CurrentPlatform.cs
@@ -147,6 +147,63 @@ public virtual int StartRegularProcess(string FileName)
             return Process.Start(FileName).Id;
         }
 
+        /// <summary>
+        /// Start the required application as the current user with specified
+        /// command-line arguments.
+        /// </summary>
+        /// <param name="FileName">Full path to the executable.</param>
+        /// <param name="Arguments">Command-line arguments.</param>
+        /// <returns>PID of the newly created process.</returns>
+        [EnvironmentPermission(SecurityAction.Demand, Unrestricted = true)]
+        public virtual int StartRegularProcess(string FileName, string Arguments)
+        {
+            ProcessStartInfo ST = new ProcessStartInfo
+            {
+                FileName = FileName,
+                Arguments = Arguments
+            };
+            return Process.Start(ST).Id;
+        }
+
+        /// <summary>
+        /// Start the required application as an administrator.
+        /// </summary>
+        /// <param name="FileName">Full path to the executable.</param>
+        /// <returns>PID of the newly created process.</returns>
+        [EnvironmentPermission(SecurityAction.Demand, Unrestricted = true)]
+        public virtual int StartElevatedProcess(string FileName)
+        {
+            return StartElevatedProcess(FileName, string.Empty);
+        }
+
+        /// <summary>
+        /// Start the required application as an administrator with the specified
+        /// command-line arguments and external helper tool.
+        /// </summary>
+        /// <param name="FileName">Full path to the executable.</param>
+        /// <param name="Arguments">Command-line arguments.</param>
+        /// <param name="ExternalHelper">External helper application for elevating permissions.</param>
+        /// <returns>PID of the newly created process.</returns>
+        [EnvironmentPermission(SecurityAction.Demand, Unrestricted = true)]
+        protected virtual int StartElevatedProcess(string FileName, string Arguments, string ExternalHelper)
+        {
+            // Setting advanced properties...
+            ProcessStartInfo ST = new ProcessStartInfo
+            {
+                FileName = FileName,
+                Arguments = Arguments,
+                Verb = ExternalHelper,
+                WindowStyle = ProcessWindowStyle.Normal,
+                UseShellExecute = true
+            };
+
+            // Starting process...
+            Process NewProcess = Process.Start(ST);
+
+            // Returning PID of created process...
+            return NewProcess.Id;
+        }
+
         /// <summary>
         /// Get platform-dependent suffix for HTTP_USER_AGENT header.
         /// </summary>
@@ -184,11 +241,13 @@ public virtual int StartRegularProcess(string FileName)
         public abstract void OpenExplorer(string FileName);
 
         /// <summary>
-        /// Start the required application from administrator.
+        /// Start the required application as an administrator with the specified
+        /// command-line arguments.
         /// </summary>
         /// <param name="FileName">Full path to the executable.</param>
+        /// <param name="Arguments">Command-line arguments.</param>
         /// <returns>PID of the newly created process.</returns>
         [EnvironmentPermission(SecurityAction.Demand, Unrestricted = true)]
-        public abstract int StartElevatedProcess(string FileName);
+        public abstract int StartElevatedProcess(string FileName, string Arguments);
     }
 }
diff --git a/src/mhlib/IPlatform.cs b/src/mhlib/IPlatform.cs
@@ -90,17 +90,35 @@ public interface IPlatform
         void RestartApplicationAsAdmin();
 
         /// <summary>
-        /// Start the required application as the current user.
+        /// Start the required application as an administrator with the specified
+        /// command-line arguments.
         /// </summary>
         /// <param name="FileName">Full path to the executable.</param>
+        /// <param name="Arguments">Command-line arguments.</param>
         /// <returns>PID of the newly created process.</returns>
-        int StartRegularProcess(string FileName);
+        int StartElevatedProcess(string FileName, string Arguments);
 
         /// <summary>
-        /// Start the required application from administrator.
+        /// Start the required application as an administrator.
         /// </summary>
         /// <param name="FileName">Full path to the executable.</param>
         /// <returns>PID of the newly created process.</returns>
         int StartElevatedProcess(string FileName);
+
+        /// <summary>
+        /// Start the required application as the current user with specified
+        /// command-line arguments.
+        /// </summary>
+        /// <param name="FileName">Full path to the executable.</param>
+        /// <param name="Arguments">Command-line arguments.</param>
+        /// <returns>PID of the newly created process.</returns>
+        int StartRegularProcess(string FileName, string Arguments);
+
+        /// <summary>
+        /// Start the required application as the current user.
+        /// </summary>
+        /// <param name="FileName">Full path to the executable.</param>
+        /// <returns>PID of the newly created process.</returns>
+        int StartRegularProcess(string FileName);
     }
 }
diff --git a/src/mhlib/PlatformLinux.cs b/src/mhlib/PlatformLinux.cs
@@ -39,27 +39,16 @@ public override void OpenExplorer(string FileName)
         }
 
         /// <summary>
-        /// Start the required application from administrator.
+        /// Start the required application as an administrator with the specified
+        /// command-line arguments.
         /// </summary>
         /// <param name="FileName">Full path to the executable.</param>
+        /// <param name="Arguments">Command-line arguments.</param>
         /// <returns>PID of the newly created process.</returns>
         [EnvironmentPermission(SecurityAction.Demand, Unrestricted = true)]
-        public override int StartElevatedProcess(string FileName)
+        public override int StartElevatedProcess(string FileName, string Arguments)
         {
-            // Setting advanced properties...
-            ProcessStartInfo ST = new ProcessStartInfo
-            {
-                FileName = FileName,
-                Verb = "pkexec",
-                WindowStyle = ProcessWindowStyle.Normal,
-                UseShellExecute = true
-            };
-
-            // Starting process...
-            Process NewProcess = Process.Start(ST);
-
-            // Returning PID of created process...
-            return NewProcess.Id;
+            return StartElevatedProcess(FileName, Arguments, "pkexec");
         }
 
         /// <summary>

diff --git a/src/mhlib/PlatformMac.cs b/src/mhlib/PlatformMac.cs
@@ -39,27 +39,16 @@ public override void OpenExplorer(string FileName)
         }
 
         /// <summary>
-        /// Start the required application from administrator.
+        /// Start the required application as an administrator with the specified
+        /// command-line arguments.
         /// </summary>
         /// <param name="FileName">Full path to the executable.</param>
+        /// <param name="Arguments">Command-line arguments.</param>
         /// <returns>PID of the newly created process.</returns>
         [EnvironmentPermission(SecurityAction.Demand, Unrestricted = true)]
-        public override int StartElevatedProcess(string FileName)
+        public override int StartElevatedProcess(string FileName, string Arguments)
         {
-            // Setting advanced properties...
-            ProcessStartInfo ST = new ProcessStartInfo
-            {
-                FileName = FileName,
-                Verb = "sudo",
-                WindowStyle = ProcessWindowStyle.Normal,
-                UseShellExecute = true
-            };
-
-            // Starting process...
-            Process NewProcess = Process.Start(ST);
-
-            // Returning PID of created process...
-            return NewProcess.Id;
+            return StartElevatedProcess(FileName, Arguments, "sudo");
         }
 
         /// <summary>

diff --git a/src/mhlib/PlatformWindows.cs b/src/mhlib/PlatformWindows.cs
@@ -40,27 +40,16 @@ public override void OpenExplorer(string FileName)
         }
 
         /// <summary>
-        /// Start the required application from administrator.
+        /// Start the required application as an administrator with the specified
+        /// command-line arguments.
         /// </summary>
         /// <param name="FileName">Full path to the executable.</param>
+        /// <param name="Arguments">Command-line arguments.</param>
         /// <returns>PID of the newly created process.</returns>
         [EnvironmentPermission(SecurityAction.Demand, Unrestricted = true)]
-        public override int StartElevatedProcess(string FileName)
+        public override int StartElevatedProcess(string FileName, string Arguments)
         {
-            // Setting advanced properties...
-            ProcessStartInfo ST = new ProcessStartInfo
-            {
-                FileName = FileName,
-                Verb = "runas",
-                WindowStyle = ProcessWindowStyle.Normal,
-                UseShellExecute = true
-            };
-
-            // Starting process...
-            Process NewProcess = Process.Start(ST);
-
-            // Returning PID of created process...
-            return NewProcess.Id;
+            return StartElevatedProcess(FileName, Arguments, "runas");
         }
 
         /// <summary>