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

Timestamp:

Jul 7, 2008 10:33:33 AM (17 years ago)

Author:

vboxsync

Message:

Main: Lock the object before switching on non-const data members.

File:

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

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

@@ -3471 +3471 @@
       <desc>
         Reads a value from the machine's host/guest property store.
+
+        Reads a value from the machine's host/guest property store.
+
+        If a session for this virtual machine is currently open then queries the
+        session object for the value, since the current values of the property
+        store will be held in RAM in the session. Otherwise reads the value from
+        machine extra data, where it is stored between sessions.
+
+        This method will fail if we are currently transitioning between session
+        states.
       </desc>
       <param name="key" type="wstring" dir="in">
@@ -3489 +3499 @@
         Sets, changes or deletes a value in the machine's host/guest
         property store.
+
+        If a session for this virtual machine is currently open then changes the
+        value on the session object, since the current values of the property
+        store will be held in RAM in the session. Otherwise changes the value
+        in machine extra data, where it is stored between sessions.
+
+        This method will fail if we are currently transitioning between session
+        states.
       </desc>
       <param name="key" type="wstring" dir="in">