org.virtualbox_5_1
Class IRuntimeErrorEvent
java.lang.Object
org.virtualbox_5_1.IUnknown
org.virtualbox_5_1.IEvent
org.virtualbox_5_1.IRuntimeErrorEvent
public class IRuntimeErrorEvent
- extends IEvent
Notification when an error happens during the virtual
machine execution.
There are three kinds of runtime errors:
- fatal
- non-fatal with retry
- non-fatal warnings
Fatalerrors are indicated by the fatal parameter set
to true. In case of fatal errors, the virtual machine
execution is always paused before calling this notification, and
the notification handler is supposed either to immediately save
the virtual machine state usingIMachine.saveState()
or power it off usingIConsole.powerDown()
.
Resuming the execution can lead to unpredictable results.Non-fatalerrors and warnings are indicated by the
fatal parameter set to false. If the virtual machine
is in the Paused state by the time the error notification is
received, it means that the user cantry to resumethe machine
execution after attempting to solve the problem that caused the
error. In this case, the notification handler is supposed
to show an appropriate message to the user (depending on the
value of the id parameter) that offers several actions such
asRetry,SaveorPower Off. If the user
wants to retry, the notification handler should continue
the machine execution using theIConsole.resume()
call. If the machine execution is not Paused during this
notification, then it means this notification is awarning(for example, about a fatal condition that can happen very soon);
no immediate action is required from the user, the machine
continues its normal execution.
Note that in either case the notification handlermust notperform any action directly on a thread
where this notification is called. Everything it is allowed to
do is to post a message to another thread that will then talk
to the user and take the corresponding action.
Currently, the following error identifiers are known:- "HostMemoryLow"
- "HostAudioNotResponding"
- "VDIStorageFull"
- "3DSupportIncompatibleAdditions"
Interface ID: {883DD18B-0721-4CDE-867C-1A82ABAF914C}
Constructor Summary |
IRuntimeErrorEvent(java.lang.String wrapped,
org.virtualbox_5_1.ObjectRefManager objMgr,
org.virtualbox_5_1.jaxws.VboxPortType port)
|
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
IRuntimeErrorEvent
public IRuntimeErrorEvent(java.lang.String wrapped,
org.virtualbox_5_1.ObjectRefManager objMgr,
org.virtualbox_5_1.jaxws.VboxPortType port)
getFatal
public java.lang.Boolean getFatal()
- Whether the error is fatal or not.
- Returns:
- Boolean
getId
public java.lang.String getId()
- Error identifier.
- Returns:
- String
getMessage
public java.lang.String getMessage()
- Optional error message.
- Returns:
- String
queryInterface
public static IRuntimeErrorEvent queryInterface(IUnknown obj)