Looks up information about a type in the Global Location Broker (GLB) database.
void lb_$lookup_type ( object_type, lookup_handle, max_results)
void lb_$lookup_type ( num_results, results, status)
uuid_$t *object_type;
lb_$lookup_handle_t *lookup_handle;
unsigned long max_results;
unsigned long *num_results;
lb_$entry_t results [ ];
status_$t *status;
The lb_$lookup_type routine returns GLB database entries whose fields in the object_type parameter match the specified type. It returns information about all replicas of all objects of that type and about all interfaces to each object.
The lb_$lookup_type routine cannot return more than the number of matching entries specified by the max_results parameter at one time. The lookup_handle parameter directs this routine to do sequential lookup calls to find all matching entries.
Input
Item | Description |
---|---|
object_type | Points to the Universal Unique Identifier (UUID) of the type being looked up. |
max_results | Specifies the maximum number of matching entries that can be returned by a single call. This should be the number of elements in the results parameter array. |
Input/Output
Item | Description |
---|---|
lookup_handle | Specifies a location in the database. On input, the value
of the lookup_handle parameter indicates the location in the
database where the search begins. An input value of lb_$default_lookup_handle specifies
that the search starts at the beginning of the database. On return, the lookup_handle parameter indicates the next unsearched part of the database (that is, the point at which the next search should begin). A return value of lb_$default_lookup_handle indicates that the search reached the end of the database. Any other value indicates that the search found at most the number of matching entries specified by the max_results parameter before it reached the end of the database. |
Output
Item | Description |
---|---|
num_results | Points to the number of entries that were returned in the results parameter array. |
results | Specifies the array that contains the matching GLB database entries, up to the number specified in the max_results parameter. If the array contains any entries for servers on the local network, those entries appear first. |
status | Points to the completion status. |
To look up information in the GLB database about the array_proc type, enter:
lb_$lookup_type (&array_proc_id, &lookup_handle, 10,
&num_results, &results, &st)
The results parameter is a 10-element array of the lb_$entry_t type.