INtime SDK Help
ntxGetRootRtProcess
INtime SDK v6 > About INtime > INtime Kernel > Object Directories > ntxGetRootRtProcess

Obtains the root RT process handle.

NTXHANDLE ntxGetRootRtProcess(
    NTXLOCATION hLoc
);

Parameters

hLoc
Location of the RT kernel whose root process handle is desired.

Return Values

The handle to the root process of the specified RT kernel.
Success.
NTX_BAD_NTXHANDLE
Failure. To determine the status, call ntxGetLastRtError.

Status

E_OK 0x0000
No exceptional conditions occurred.
E_STATE 0x0007
This request was made in the context of a hardware interrupt handler which could cause the DOS thread state to be indeterminate. This is a DOS RTE error only.
E_PARAM 0x8004
The specified location is not an NTX location.
E_LOCATION
The specified location doesn't exist.
E_NTX_INTERNAL_ERROR
The DLL could not contact the RT kernel to complete the request.

Requirements

Versions Defined in Include Link to
INtime 3.0 intime/nt/include/ntx.h ntx.h ntx.lib
INtime 4.01 (for 64-bit Windows) intime/nt/include/ntx.h ntx.h ntx64.lib
   
See Also