Starts a process loaded with the NTX_PROC_SUSPEND option flag set.

NTXSTATUS StartRtProcess(
    NTXHANDLE hProcess,
    NTXHANDLE *phExit);

Parameters

hProcess

The handle for the loaded process.

phExit

A pointer to a location which receives the wait handle for subsequent use with the ntxWaitForRtProcess call.

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 ntxWaitForRtProcessEx 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 NTX_PROC_SUSPEND flag set, then the call returns NTX_BAD_NTXHANDLE and the last error status is set to E_STATE.

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

Return Values

On success a valid wait handle is returned via the phExit parameter and E_OK returned. If the call fails, or wait handle was not able to be created, the call returns 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 NTX_PROC_SUSPEND flag set.
E_CONTEXT	The call was not able to return a wait handle, but the process was nevertheless started.

Requirements