SE_stateinfo_get_lineage64 |
Retrieves the lineage of a state as an array
LONG SE_stateinfo_get_lineage64 (const SE_STATEINFO state, LONG **lineage, LONG *count);
state | The state handle |
lineage | Address of a pointer in a dynamically allocated space that will contain an variable length array of state IDs |
count | The number of state IDs in the lineage |
This function returns a variable length array of 64-bit state IDs that comprise a states lineage. The lineage includes an ordered list of the state IDs. The total number of IDs is returned in the count parameter. The application must free the lineage to reclaim the memory allocated by this function with SE_stateinfo_free array.
SE_SUCCESS
SE_INVALID_POINTER
SE_INVALID_STATEINFO_OBJECT
SE_NET_FAILURE
SE_OUT_OF_CLMEM
SE_SDE_NOT_STARTED