INtime SDK Help
StartRtProcess
INtime SDK v6 > About INtime > INtime Kernel > Processes > StartRtProcess

Starts a process loaded with the PROC_SUSPEND option flag set.

RTHANDLE StartRtProcess(
RTHANDLE hProcess);

Parameters

hProcess
The handle for the loaded process.

Remarks

The process to be started must have been created with the PROC_SUSPEND flag set (or NTX_PROC_SUSPEND flag for ntxCreateRtProcess). The call returns a handle which must be used in a subsequent call to WaitForRtProcessEx to allow the process creator to synchronize with the termination of the created process, and to receive its exit code.

If the process was not created with the PROC_SUSPEND flag set, then the call returns BAD_RTHANDLE and the last error status is set to E_STATE.

If the call is not able to create a wait handle, the call returns BAD_RTHANDLE and the last error status is set to E_CONTEXT.

Return Values

On success a valid wait handle is returned. If the call fails, or if the wait handle was not able to be created, the call returns BAD_RTHANDLE and GetLastRtError() will return the error status.

Possible status codes include the following:

E_TYPE The process handle was not a handle for a process.
E_EXIST The process has been deleted.
E_STATE The process was not created with the PROC_SUSPEND flag set.
E_CONTEXT The call was not able to return a wait handle, but the process was nevertheless started.

Requirements

Versions Defined in Include Link to
INtime 6.0 intime/rt/include/rtbase.h rt.h rt.lib
See Also

NTX