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