INtime SDK Help
GetRemoteRootRtProcess
INtime SDK v7.1 > About INtime > INtime Kernel > Global objects > GetRemoteRootRtProcess

Returns a handle for a reference to the target node's root process. The reference object adds to the calling process' object count and should be deleted when it is finished with.

#include <rt.h>

RTHANDLE GetRemoteRootRtProcess(
    LOCATION hLoc
);

Parameters

hLoc
The location handle of the node whose root process handle is sought.

Return Values

A valid RTHANDLE
Success.
BAD_RTHANDLE
Failure. The function sets GetLastRtError to one of these values:
E_INVALID_ADDR The location parameter does not refer to a known location.
E_RESOURCE_LIMIT Unable to allocate a message buffer.
E_MEM Insufficient physical memory exists to create the object.
E_SLOT The maximum number of objects has been exceeded on the local node.
E_INVALID_ADDRESS (0x00E2) The address provided for hLoc is not a valid address.

Requirements

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