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