Changeset 72067 in vbox for trunk/src/VBox/Main/idl/VirtualBox.xidl

Timestamp:

Apr 30, 2018 10:27:37 AM (7 years ago)

Author:

vboxsync

Message:

Guest Control/Main: Made IGuestSession::copyFromGuest() and IGuestSession::copyToGuest() more compatible by using a string array for the file / directory copy flags.

File:

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

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

@@ -11145 +11145 @@
 
   <enum
-    name="GuestCopyFlag"
-    uuid="84d6430f-dfe6-4415-a26d-3cdde1c3205a"
-    >
-    <desc>
-      Flags for use when copying elements from or to the guest, see
-      <link to="IGuestSession::copyFromGuest"/> and
-      <link to="IGuestSession::copyToGuest"/>.
-    </desc>
-
-    <const name="NoReplace"             value="0">
-      <desc>Do not replace any destination object.</desc>
-    </const>
-    <const name="Replace"               value="1">
-      <desc>This will attempt to replace any destination object other except
-        directories. (The default is to fail if the destination exists.)</desc>
-    </const>
-    <const name="CopyIntoExisting"      value="2">
-      <desc>Allow copying into an existing destination directory.</desc>
-    </const>
-    <const name="Recursive"             value="4">
-      <desc>Copies directories recursively.</desc>
-    </const>
-    <const name="FollowSymlinks"        value="8">
-      <desc>Follows (and handles) symbolic links.</desc>
-    </const>
-  </enum>
-
-  <enum
     name="ProcessCreateFlag"
     uuid="C544CD2B-F02D-4886-9901-71C523DB8DC5"
@@ -11898 +11870 @@
   <interface
     name="IGuestSession" extends="$unknown"
-    uuid="a71fcf9a-a45e-440a-886a-5b4c664195ef"
+    uuid="9880f6e3-c4c1-4031-8ec2-28ee088370e4"
     wsmap="managed"
     reservedMethods="8" reservedAttributes="8"
@@ -12074 +12046 @@
       </param>
       <param name="filters" type="wstring" dir="in" safearray="yes">
-        <desc>Array of filters corresponding to the sources. This uses the
+        <desc>Array of source filters. This uses the
           DOS/NT style wildcard characters '?' and '*'.</desc>
       </param>
       <param name="types" type="FsObjType" dir="in" safearray="yes">
-        <desc>Array of <link to="FsObjType"/> types which define the type of
-          source entries.</desc>
-      </param>
-      <param name="flags" type="GuestCopyFlag" dir="in" safearray="yes">
-        <desc>Array of <link to="GuestCopyFlag"/> flags corresponding to the
-          sources.</desc>
+        <desc>Array of source <link to="FsObjType"/> types.</desc>
+      </param>
+      <param name="flags" type="wstring" dir="in" safearray="yes">
+        <desc>Array of comma-separated list of source flags.
+
+          The following flags are available for directory sources:
+
+          <table>
+            <tr>
+              <td>CopyIntoExisting</td>
+              <td>Allow copying into an existing destination directory.</td>
+            </tr>
+          </table>
+
+          The following flags are available for file sources:
+
+          <table>
+            <tr>
+              <td>NoReplace</td>
+              <td>Do not replace any destination object.</td>
+            </tr>
+            <tr>
+              <td>FollowLinks</td>
+              <td>Follows (and handles) (symbolic) links.</td>
+            </tr>
+            <tr>
+              <td>Update</td>
+              <td>Only copy when the source file is newer than the destination
+               file or when the destination file is missing.</td>
+            </tr>
+          </table>
+
+        </desc>
       </param>
       <param name="destination" type="wstring" dir="in">
@@ -12105 +12104 @@
       </param>
       <param name="filters" type="wstring" dir="in" safearray="yes">
-        <desc>Array of filters corresponding to the sources. This uses the
+        <desc>Array of source filters. This uses the
           DOS/NT style wildcard characters '?' and '*'.</desc>
       </param>
       <param name="types" type="FsObjType" dir="in" safearray="yes">
-        <desc>Array of <link to="FsObjType"/> types which define the type of
-          source entries.</desc>
-      </param>
-      <param name="flags" type="GuestCopyFlag" dir="in" safearray="yes">
-        <desc>Array of <link to="GuestCopyFlag"/> flags corresponding to the
-          sources.</desc>
+        <desc>Array of source <link to="FsObjType"/> types.</desc>
+      </param>
+      <param name="flags" type="wstring" dir="in" safearray="yes">
+        <desc>Array of comma-separated list of source flags.
+
+          The following flags are available for directory sources:
+
+          <table>
+            <tr>
+              <td>CopyIntoExisting</td>
+              <td>Allow copying into an existing destination directory.</td>
+            </tr>
+          </table>
+
+          The following flags are available for file sources:
+
+          <table>
+            <tr>
+              <td>NoReplace</td>
+              <td>Do not replace any destination object.</td>
+            </tr>
+            <tr>
+              <td>FollowLinks</td>
+              <td>Follows (and handles) (symbolic) links.</td>
+            </tr>
+            <tr>
+              <td>Update</td>
+              <td>Only copy when the source file is newer than the destination
+               file or when the destination file is missing.</td>
+            </tr>
+          </table>
+
+        </desc>
       </param>
       <param name="destination" type="wstring" dir="in">