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