Changeset 48505 in vbox

Timestamp:

Sep 17, 2013 3:48:55 PM (11 years ago)

Author:

vboxsync

Message:

Main/Machine: preparations for moving machines to a different place on disk

Location:

trunk/src/VBox/Main

Files:

• idl/VirtualBox.xidl (modified) (2 diffs)
• include/MachineImpl.h (modified) (1 diff)
• src-server/MachineImpl.cpp (modified) (1 diff)

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

@@ -4122 +4122 @@
   <interface
     name="IMachine" extends="$unknown"
-    uuid="59b33148-7f87-4224-82a7-d141ef49fc0d"
+    uuid="8c931034-83f6-46b8-97f0-31e70d30402e"
     wsmap="managed"
     >
@@ -4548 +4548 @@
     </attribute>
 
-    <attribute name="settingsFilePath" type="wstring" readonly="yes">
+    <attribute name="settingsFilePath" type="wstring">
       <desc>
         Full name of the file containing machine settings data.
+
+        Currently, it is an error to change this property on any machine.
+        Later this will allow setting a new path for the settings file, with
+        automatic relocation of all files (including snapshots and disk images)
+        which are inside the base directory.
+
+        <note>
+          Setting this property to @c null or to an empty string is forbidden. 
+        </note>
+        <note>
+          When setting this property, the specified path must be absolute. When
+          reading this property, an absolute (full) path is always returned.
+        </note>
+        <note>
+          The specified path may not exist, it will be created when necessary.
+        </note>
       </desc>
     </attribute>

trunk/src/VBox/Main/include/MachineImpl.h

@@ -457 +457 @@
     STDMETHOD(COMGETTER(USBDeviceFilters))(IUSBDeviceFilters * *aUSBDeviceFilters);
     STDMETHOD(COMGETTER(SettingsFilePath))(BSTR *aFilePath);
+    STDMETHOD(COMSETTER(SettingsFilePath))(IN_BSTR aFilePath);
     STDMETHOD(COMGETTER(SettingsModified))(BOOL *aModified);
     STDMETHOD(COMGETTER(SessionState))(SessionState_T *aSessionState);

trunk/src/VBox/Main/src-server/MachineImpl.cpp

@@ -2752 +2752 @@
     mData->m_strConfigFileFull.cloneTo(aFilePath);
     return S_OK;
+}
+
+STDMETHODIMP Machine::COMSETTER(SettingsFilePath)(IN_BSTR aFilePath)
+{
+    CheckComArgStrNotEmptyOrNull(aFilePath);
+
+    AutoCaller autoCaller(this);
+    if (FAILED(autoCaller.rc())) return autoCaller.rc();
+
+    ReturnComNotImplemented();
 }