|
VirtualBox Main API
|
Abstract parent interface for processes handled by VirtualBox. More...
Public Member Functions | |
| void | waitFor (in unsigned long waitFor, in unsigned long timeoutMS, [retval] out ProcessWaitResult reason) |
| Waits for one or more events to happen. | |
| void | waitForArray (in ProcessWaitForFlag[] waitFor, in unsigned long timeoutMS, [retval] out ProcessWaitResult reason) |
| Waits for one or more events to happen. | |
| void | read (in unsigned long handle, in unsigned long toRead, in unsigned long timeoutMS, [retval] out octet[] data) |
| Reads data from a running process. | |
| void | write (in unsigned long handle, in unsigned long flags, in octet[] data, in unsigned long timeoutMS, [retval] out unsigned long written) |
| Writes data to a running process. | |
| void | writeArray (in unsigned long handle, in ProcessInputFlag[] flags, in octet[] data, in unsigned long timeoutMS, [retval] out unsigned long written) |
| Writes data to a running process. | |
| void | terminate () |
| Terminates (kills) a running process. | |
Public Attributes | |
| readonly attribute wstring[] | arguments |
| The arguments this process is using for execution. | |
| readonly attribute wstring[] | environment |
| The initial process environment. | |
| readonly attribute IEventSource | eventSource |
| Event source for process events. | |
| readonly attribute wstring | executablePath |
| Full path of the actual executable image. | |
| readonly attribute long | exitCode |
| The exit code. | |
| readonly attribute wstring | name |
| The friendly name of this process. | |
| readonly attribute unsigned long | PID |
| The process ID (PID). | |
| readonly attribute ProcessStatus | status |
| The current process status; see ProcessStatus for more information. | |
Abstract parent interface for processes handled by VirtualBox.
{BC68370C-8A02-45F3-A07D-A67AA72756AA} | void IProcess::waitFor | ( | in unsigned long | waitFor, |
| in unsigned long | timeoutMS, | ||
| [retval] out ProcessWaitResult | reason | ||
| ) |
Waits for one or more events to happen.
| waitFor | Specifies what to wait for; see ProcessWaitForFlag for more information. |
| timeoutMS | Timeout (in ms) to wait for the operation to complete. Pass 0 for an infinite timeout. |
| reason | The overall wait result; see ProcessWaitResult for more information. |
| void IProcess::waitForArray | ( | in ProcessWaitForFlag[] | waitFor, |
| in unsigned long | timeoutMS, | ||
| [retval] out ProcessWaitResult | reason | ||
| ) |
Waits for one or more events to happen.
Scriptable version of waitFor.
| waitFor | Specifies what to wait for; see ProcessWaitForFlag for more information. |
| timeoutMS | Timeout (in ms) to wait for the operation to complete. Pass 0 for an infinite timeout. |
| reason | The overall wait result; see ProcessWaitResult for more information. |
| void IProcess::read | ( | in unsigned long | handle, |
| in unsigned long | toRead, | ||
| in unsigned long | timeoutMS, | ||
| [retval] out octet[] | data | ||
| ) |
Reads data from a running process.
| handle | Handle to read from. Usually 0 is stdin. |
| toRead | Number of bytes to read. |
| timeoutMS | Timeout (in ms) to wait for the operation to complete. Pass 0 for an infinite timeout. |
| data | Array of data read. |
| void IProcess::write | ( | in unsigned long | handle, |
| in unsigned long | flags, | ||
| in octet[] | data, | ||
| in unsigned long | timeoutMS, | ||
| [retval] out unsigned long | written | ||
| ) |
Writes data to a running process.
| handle | Handle to write to. Usually 0 is stdin, 1 is stdout and 2 is stderr. |
| flags | A combination of ProcessInputFlag flags. |
| data | Array of bytes to write. The size of the array also specifies how much to write. |
| timeoutMS | Timeout (in ms) to wait for the operation to complete. Pass 0 for an infinite timeout. |
| written | How many bytes were written. |
| void IProcess::writeArray | ( | in unsigned long | handle, |
| in ProcessInputFlag[] | flags, | ||
| in octet[] | data, | ||
| in unsigned long | timeoutMS, | ||
| [retval] out unsigned long | written | ||
| ) |
Writes data to a running process.
Scriptable version of write.
| handle | Handle to write to. Usually 0 is stdin, 1 is stdout and 2 is stderr. |
| flags | A combination of ProcessInputFlag flags. |
| data | Array of bytes to write. The size of the array also specifies how much to write. |
| timeoutMS | Timeout (in ms) to wait for the operation to complete. Pass 0 for an infinite timeout. |
| written | How may bytes were written. |
| void IProcess::terminate | ( | ) |
Terminates (kills) a running process.
| readonly attribute wstring [] IProcess::arguments |
The arguments this process is using for execution.
| readonly attribute wstring [] IProcess::environment |
The initial process environment.
Not yet implemented.
| readonly attribute IEventSource IProcess::eventSource |
Event source for process events.
| readonly attribute wstring IProcess::executablePath |
Full path of the actual executable image.
| readonly attribute long IProcess::exitCode |
The exit code.
Only available when the process has been terminated normally.
| readonly attribute wstring IProcess::name |
The friendly name of this process.
| readonly attribute unsigned long IProcess::PID |
The process ID (PID).
| readonly attribute ProcessStatus IProcess::status |
The current process status; see ProcessStatus for more information.