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