INtime SDK Help
INtime SDK v7 > About INtime > INtime Kernel > Global objects > GetRtNodeLocationByName

Returns a LOCATION for the given name.

#include <rt.h> 
    LOCATION GetRtNodeLocationByName(const char *NodeName);



An zero-terminated ASCII string containing the name of the node whose location is sought. The format of NodeName can be one of the following:

For nodes on the same host as the caller:

"node-only" form; the name of a node with no host name, e.g. "NodeA"
"null url" form
"hostless url" form

For nodes on other hosts:

"full url" format, e.g. intime://
"host+node" form


This call does not interact with the target node.

Return Values

A valid LOCATION handle
Success; the name is valid.
Failure. The function sets GetLastRtError to one of these values:
E_BAD_ADDR NodeName is not a valid pointer to a zero-terminated string.
E_PARAM NodeName is invalid (longer than 63 characters).
E_INVALID_ADDR Location does not exist.


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