public class IRuntimeErrorEvent extends IEvent
IMachine.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"
{883DD18B-0721-4CDE-867C-1A82ABAF914C}
Constructor and Description |
---|
IRuntimeErrorEvent(java.lang.String wrapped,
org.virtualbox_7_0.ObjectRefManager objMgr,
org.virtualbox_7_0.jaxws.VboxPortType port) |
Modifier and Type | Method and Description |
---|---|
java.lang.Boolean |
getFatal()
Whether the error is fatal or not.
|
java.lang.String |
getId()
Error identifier.
|
java.lang.String |
getMessage()
Optional error message.
|
static IRuntimeErrorEvent |
queryInterface(IUnknown obj) |
getSource, getType, getWaitable, setProcessed, waitProcessed
getObjMgr, getRemoteWSPort, getWrapped, releaseRemote
public IRuntimeErrorEvent(java.lang.String wrapped, org.virtualbox_7_0.ObjectRefManager objMgr, org.virtualbox_7_0.jaxws.VboxPortType port)
public java.lang.Boolean getFatal()
public java.lang.String getId()
public java.lang.String getMessage()
public static IRuntimeErrorEvent queryInterface(IUnknown obj)