Ets_Topo_Connect_Count_Get()
Abstract
Returns the number of unique objects which connect the specified source object to the specified destination object.
Syntax
Ets_Topo_Connect_Count_Get (src_obj_hndl, dest_obj_hndl, connect_mtype)
| Argument | Type | Description |
|---|---|---|
src_obj_hndl |
EtsT_Obj_Handle |
Handle to source object. |
dest_obj_hndl |
EtsT_Obj_Handle |
Handle to destination object. |
connect_mtype |
“EtsT_Obj_Type“ |
Value specifying the type or meta-type of connecting objects (one of the values in Table 33 “General Sub-Package Symbolic Constants“ on page 1046). |
Return Type
int
Number of unique connecting objects of the specified type.
Header
ets_api_topo.h
Details
When the source and destination objects are network node (or bus) objects, the connecting objects are either simplex links (or taps) that point from the source object to the destination object, or are duplex links or paths. Currently, both the source and destination object must be in the same subnet and all connecting objects will also be in that subnet.
The connect_mtype argument can be either a specific object type (such as EtsC_Obj_Type_Lkdup) or a general object meta-type (such as EtsC_Obj_Mtype_All).
The function Ets_Topo_Connect_Get() will return an ETS object handle for each of the counted objects when called with the same source and destination objects, the same object type, and an index ranging from zero (inclusive) and the count (exclusive).