INtime SDK Help
GetRtNodeLocationByName
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);

Parameters

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:

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

For nodes on other hosts:

"intime://hostname/nodename"
"full url" format, e.g. intime://rtoshost.mydomain.com/NodeA
"hostname/nodename"
"host+node" form

Remarks

This call does not interact with the target node.

Return Values

A valid LOCATION handle
Success; the name is valid.
BAD_LOCATION
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.

Requirements

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