Changeset 18649 in vbox

Timestamp:

Apr 2, 2009 4:24:49 PM (16 years ago)

Author:

vboxsync

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

45574

Message:

VMSetRuntimeError: clearification, status codes *must* be propagated, there are no FFs mopping them up.

Location:

trunk

Files:

• include/VBox/vmapi.h (modified) (1 diff)
• src/VBox/VMM/VMMAll/VMAll.cpp (modified) (2 diffs)

trunk/include/VBox/vmapi.h

@@ -156 +156 @@
 /** The error is fatal.
  * The VM is not in a state where it can be saved and will enter a state
- * where it can no longer execute code. The caller must propagate status
+ * where it can no longer execute code. The caller <b>must</b> propagate status
  * codes. */
 #define VMSETRTERR_FLAGS_FATAL      RT_BIT_32(0)
 /** Suspend the VM after, or if possible before, raising the error on EMT. The
- * caller must propagate status codes. */
+ * caller <b>must</b> propagate status codes. */
 #define VMSETRTERR_FLAGS_SUSPEND    RT_BIT_32(1)
 /** Don't wait for the EMT to handle the request.

trunk/src/VBox/VMM/VMMAll/VMAll.cpp

@@ -193 +193 @@
  * execution (like "host memory low" or "out of host disk space").
  *
- * @returns VBox status code. For some flags the status code needs to be
- *          propagated up the stack, but this may depend on where the call was
- *          made.
+ * @returns VBox status code. For some flags the status code <b>must</b> be
+ *          propagated up the stack.
  *
  * @param   pVM             The VM handle.
@@ -230 +229 @@
  * va_list version of VMSetRuntimeError.
  *
- * @returns VBox status code. For some flags the status code needs to be
- *          propagated up the stack, but this may depend on where the call was
- *          made. For most actions, there is a force action flag mopping up if
- *          the status code can't be propagated.
+ * @returns VBox status code. For some flags the status code <b>must</b> be
+ *          propagated up the stack.
  *
  * @param   pVM             The VM handle.