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:

## 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.