Changeset 99150 in vbox for trunk/src/VBox/Main/idl

Timestamp:

Mar 23, 2023 6:00:47 PM (2 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

156515

Message:

Guest Control: Changed the parameter position of the CWD parameter, so that the image name and arguments are together again (feels more natural, was part of the initial patch). bugref:8053

File:

• trunk/src/VBox/Main/idl/VirtualBox.xidl (modified) (5 diffs)

trunk/src/VBox/Main/idl/VirtualBox.xidl

@@ -14814 +14814 @@
   <interface
     name="IGuestSession" extends="$unknown"
-    uuid="5591bead-9c1d-4cbd-9669-2d0b04fac0a8"
+    uuid="5e54f60b-6dcd-4594-a6c9-cf968f004341"
     wsmap="managed"
     reservedMethods="8" reservedAttributes="12"
@@ -15966 +15966 @@
         </desc>
       </param>
-      <param name="cwd" type="wstring" dir="in">
-        <desc>
-          Path to the directory in which to execute in the guest.  The
-          directory has to exist in the guest VM with search rights to the
-          session user in order to succeed.  If empty/null, the session
-          user's default (typically 'home') directory is used.  If not a
-          full path, it is interpreted relative to the default directory;
-          e.g. 'work' means '$HOME/work' (according to the guest's '$HOME'-
-          like concept).
-        </desc>
-      </param>
       <param name="arguments" type="wstring" dir="in" safearray="yes">
         <desc>Array of arguments passed to the new process.
@@ -15988 +15977 @@
         </desc>
       </param>
-      <param name="environmentChanges" type="wstring" dir="in" safearray="yes">
-        <desc>
-          Set of environment changes to complement
-          <link to="IGuestSession::environmentChanges"/>.  Takes precedence
-          over the session ones.  The changes are in putenv format, i.e.
-          "VAR=VALUE" for setting and "VAR" for unsetting.
-
-          The changes are applied to the base environment of the impersonated
-          guest user (<link to="IGuestSession::environmentBase"/>) when
-          creating the process.  (This is done on the guest side of things in
-          order to be compatible with older Guest Additions.  That is one of
-          the motivations for not passing in the whole environment here.)
-        </desc>
-      </param>
-      <param name="flags" type="ProcessCreateFlag" dir="in" safearray="yes">
-        <desc>
-          Process creation flags;
-          see <link to="ProcessCreateFlag"/> for more information.
-        </desc>
-      </param>
-      <param name="timeoutMS" type="unsigned long" dir="in">
-        <desc>
-          Timeout (in ms) for limiting the guest process' running time.
-          Pass 0 for an infinite timeout. On timeout the guest process will be
-          killed and its status will be put to an appropriate value. See
-          <link to="ProcessStatus"/> for more information.
-        </desc>
-      </param>
-      <param name="guestProcess" type="IGuestProcess" dir="return">
-        <desc>Guest process object of the newly created process.</desc>
-      </param>
-    </method>
-
-    <method name="processCreateEx">
-      <desc>
-        Creates a new process running in the guest with the extended options
-        for setting the process priority and affinity.
-
-        See <link to="IGuestSession::processCreate"/> for more information.
-      </desc>
       <param name="cwd" type="wstring" dir="in">
         <desc>
@@ -16039 +15988 @@
         </desc>
       </param>
+      <param name="environmentChanges" type="wstring" dir="in" safearray="yes">
+        <desc>
+          Set of environment changes to complement
+          <link to="IGuestSession::environmentChanges"/>.  Takes precedence
+          over the session ones.  The changes are in putenv format, i.e.
+          "VAR=VALUE" for setting and "VAR" for unsetting.
+
+          The changes are applied to the base environment of the impersonated
+          guest user (<link to="IGuestSession::environmentBase"/>) when
+          creating the process.  (This is done on the guest side of things in
+          order to be compatible with older Guest Additions.  That is one of
+          the motivations for not passing in the whole environment here.)
+        </desc>
+      </param>
+      <param name="flags" type="ProcessCreateFlag" dir="in" safearray="yes">
+        <desc>
+          Process creation flags;
+          see <link to="ProcessCreateFlag"/> for more information.
+        </desc>
+      </param>
+      <param name="timeoutMS" type="unsigned long" dir="in">
+        <desc>
+          Timeout (in ms) for limiting the guest process' running time.
+          Pass 0 for an infinite timeout. On timeout the guest process will be
+          killed and its status will be put to an appropriate value. See
+          <link to="ProcessStatus"/> for more information.
+        </desc>
+      </param>
+      <param name="guestProcess" type="IGuestProcess" dir="return">
+        <desc>Guest process object of the newly created process.</desc>
+      </param>
+    </method>
+
+    <method name="processCreateEx">
+      <desc>
+        Creates a new process running in the guest with the extended options
+        for setting the process priority and affinity.
+
+        See <link to="IGuestSession::processCreate"/> for more information.
+      </desc>
       <param name="executable" type="wstring" dir="in">
         <desc>
@@ -16056 +16045 @@
             <link to="IGuestSession::protocolVersion"/> is 3 or higher.
           </note>
+        </desc>
+      </param>
+      <param name="cwd" type="wstring" dir="in">
+        <desc>
+          Path to the directory in which to execute in the guest.  The
+          directory has to exist in the guest VM with search rights to the
+          session user in order to succeed.  If empty/null, the session
+          user's default (typically 'home') directory is used.  If not a
+          full path, it is interpreted relative to the default directory;
+          e.g. 'work' means '$HOME/work' (according to the guest's '$HOME'-
+          like concept).
         </desc>
       </param>