VirtualBox Main API
Public Attributes | List of all members
IGuestProcessStateChangedEvent Interface Reference

Notification when a guest process changed its state. More...

Inheritance diagram for IGuestProcessStateChangedEvent:
IGuestProcessEvent IGuestSessionEvent IEvent

Public Attributes

readonly attribute ProcessStatus status
 New guest process status.
 
readonly attribute IVirtualBoxErrorInfo error
 Error information in case of new session status is indicating an error.
 
- Public Attributes inherited from IGuestProcessEvent
readonly attribute IGuestProcess process
 Guest process object which is related to this event.
 
readonly attribute unsigned long pid
 Guest process ID (PID).
 
- Public Attributes inherited from IGuestSessionEvent
readonly attribute IGuestSession session
 Guest session that is subject to change.
 
- Public Attributes inherited from IEvent
readonly attribute VBoxEventType type
 Event type.
 
readonly attribute IEventSource source
 Source of this event.
 
readonly attribute boolean waitable
 If we can wait for this event being processed.
 

Additional Inherited Members

- Public Member Functions inherited from IEvent
void setProcessed ()
 Internal method called by the system when all listeners of a particular event have called IEventSource::eventProcessed.
 
void waitProcessed (in long timeout, [retval] out boolean result)
 Wait until time outs, or this event is processed.
 

Detailed Description

Notification when a guest process changed its state.

Interface ID:
{C365FB7B-4430-499F-92C8-8BED814A567A}

Member Data Documentation

◆ status

readonly attribute ProcessStatus IGuestProcessStateChangedEvent::status

New guest process status.

◆ error

readonly attribute IVirtualBoxErrorInfo IGuestProcessStateChangedEvent::error

Error information in case of new session status is indicating an error.

The attribute IVirtualBoxErrorInfo::resultDetail will contain the runtime (IPRT) error code from the guest. See include/iprt/err.h and include/VBox/err.h for details.