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