INtime SDK Help
GetFirstRtLocation, GetNextRtLocation
INtime SDK v7 > About INtime > INtime Kernel > Global objects > GetFirstRtLocation, GetNextRtLocation

Returns the first or next LOCATION handle from the local location table.

#include <rt.h>
 
    LOCATION GetFirstRtLocation(void); 
    LOCATION GetNextRtLocation(LOCATION loc);

Parameters

loc
A LOCATION value returned either from GetFirstRtLocation or by GetRtNextLocation.

Remarks

GetFirstRtLocation returns the first LOCATION handle known to the local node from its internal table. This may then be used in subsequent calls to GetNextRtLocation to determine the other locations known to the local node.

Return Values

A valid LOCATION handle
Success.
BAD_LOCATION
No more locations are available. The function sets GetLastRtError to one of these values:
E_INVALID_ADDR The loc parameter supplied to GetNextRtLocation was unknown on this node.
E_EXIST No further locations are available

Requirements

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