Public Member Functions | |
void | onMachineStateChange (in uuid machineId, in MachineState state) |
The execution state of the given machine has changed. | |
void | onMachineDataChange (in uuid machineId) |
Any of the settings of the given machine has changed. | |
void | onExtraDataCanChange (in uuid machineId, in wstring key, in wstring value, out wstring error,[retval] out boolean allowChange) |
Notification when someone tries to change extra data for either the given machine or (if null) global extra data. | |
void | onExtraDataChange (in uuid machineId, in wstring key, in wstring value) |
Notification when machine specific or global extra data has changed. | |
void | onMediaRegistered (in uuid mediaId, in DeviceType mediaType, in boolean registered) |
The given media was registered or unregistered within this VirtualBox installation. | |
void | onMachineRegistered (in uuid machineId, in boolean registered) |
The given machine was registered or unregistered within this VirtualBox installation. | |
void | onSessionStateChange (in uuid machineId, in SessionState state) |
The state of the session for the given machine was changed. | |
void | onSnapshotTaken (in uuid machineId, in uuid snapshotId) |
A new snapshot of the machine has been taken. | |
void | onSnapshotDiscarded (in uuid machineId, in uuid snapshotId) |
Snapshot of the given machine has been discarded. | |
void | onSnapshotChange (in uuid machineId, in uuid snapshotId) |
Snapshot properties (name and/or description) have been changed. | |
void | onGuestPropertyChange (in uuid machineId, in wstring name, in wstring value, in wstring flags) |
Notification when a guest property has changed. |
void IVirtualBoxCallback::onMachineStateChange | ( | in uuid | machineId, | |
in MachineState | state | |||
) |
The execution state of the given machine has changed.
machineId | ID of the machine this event relates to. | |
state | New execution state. |
void IVirtualBoxCallback::onMachineDataChange | ( | in uuid | machineId | ) |
Any of the settings of the given machine has changed.
machineId | ID of the machine this event relates to. |
void IVirtualBoxCallback::onExtraDataCanChange | ( | in uuid | machineId, | |
in wstring | key, | |||
in wstring | value, | |||
out wstring | error, | |||
[retval] out boolean | allowChange | |||
) |
Notification when someone tries to change extra data for either the given machine or (if null) global extra data.
This gives the chance to veto against changes.
machineId | ID of the machine this event relates to (null ID for global extra data change requests). | |
key | Extra data key for the attempted write. | |
value | Extra data value for the given key. | |
error | Optional error message describing the reason of the veto (ignored if this notification returns true ). | |
allowChange | Flag to indicate whether the callee agrees (@ true) or vetoes against the change (@ false). |
void IVirtualBoxCallback::onExtraDataChange | ( | in uuid | machineId, | |
in wstring | key, | |||
in wstring | value | |||
) |
Notification when machine specific or global extra data has changed.
machineId | ID of the machine this event relates to. Null for global extra data changes. | |
key | Extra data key that has changed. | |
value | Extra data value for the given key. |
void IVirtualBoxCallback::onMediaRegistered | ( | in uuid | mediaId, | |
in DeviceType | mediaType, | |||
in boolean | registered | |||
) |
The given media was registered or unregistered within this VirtualBox installation.
The mediaType parameter describes what type of media the specified mediaId refers to. Possible values are:
Note that if this is a deregistration notification, there is no way to access the object representing the unregistered media. It is supposed that the application will do required cleanup based on the mediaId value.
mediaId | ID of the media this event relates to. | |
mediaType | Type of the media this event relates to. | |
registered | If true, the media was registered, otherwise it was unregistered. |
void IVirtualBoxCallback::onMachineRegistered | ( | in uuid | machineId, | |
in boolean | registered | |||
) |
The given machine was registered or unregistered within this VirtualBox installation.
machineId | ID of the machine this event relates to. | |
registered | If true, the machine was registered, otherwise it was unregistered. |
void IVirtualBoxCallback::onSessionStateChange | ( | in uuid | machineId, | |
in SessionState | state | |||
) |
The state of the session for the given machine was changed.
machineId | ID of the machine this event relates to. | |
state | New session state. |
void IVirtualBoxCallback::onSnapshotTaken | ( | in uuid | machineId, | |
in uuid | snapshotId | |||
) |
A new snapshot of the machine has been taken.
machineId | ID of the machine this event relates to. | |
snapshotId | ID of the new snapshot. |
void IVirtualBoxCallback::onSnapshotDiscarded | ( | in uuid | machineId, | |
in uuid | snapshotId | |||
) |
Snapshot of the given machine has been discarded.
machineId | ID of the machine this event relates to. | |
snapshotId | ID of the discarded snapshot. null means the current machine state has been discarded (restored from the current snapshot). |
void IVirtualBoxCallback::onSnapshotChange | ( | in uuid | machineId, | |
in uuid | snapshotId | |||
) |
Snapshot properties (name and/or description) have been changed.
machineId | ID of the machine this event relates to. | |
snapshotId | ID of the changed snapshot. |
void IVirtualBoxCallback::onGuestPropertyChange | ( | in uuid | machineId, | |
in wstring | name, | |||
in wstring | value, | |||
in wstring | flags | |||
) |
Notification when a guest property has changed.
machineId | ID of the machine this event relates to. | |
name | The name of the property that has changed. | |
value | The new property value. | |
flags | The new property flags. |