SEDRIS Reference Manual
APPENDIX C - Transmittal Access Level 0 API Auxiliary Functions Functions SE CloneHierarchySelectParameters |
---|
extern SE_Status_Code | ||||
SE_CloneHierarchySelectParameters | ||||
( | ||||
const | SE_Hierarchy_Select_Parameters | * | src_ptr, | 1 |
SE_Hierarchy_Select_Parameters | * | dest_ptr | 2 | |
); |
Duplicates the data in a SE_Hierarchy_Select_Parameters structure by allocating memory for its internal pointers (if any are in use), then populating it with data from the input SE_Hierarchy_Select_Parameters structure. This function avoids the problems associated with doing a simple member-wise copy of the structure.
SE_STATCODE_SUCCESS | and memory is allocated for any dynamically allocated data within the structure, which is then populated with data copied from *src_ptr, if valid parameters were passed in and all operations succeeded. |
SE_STATCODE_INACTIONABLE_FAILURE | and *dest_ptr is initialized to empty, if the call failed for any reason. |
1 the SE_Hierarchy_Select_Parameters that is to be duplicated
2 a pointer to an SE_Hierarchy_Select_Parameters structure within memory managed by the caller. Non-dynamically allocated fields in this structure will be directly populated with data from the input fields. Dynamically allocated data will be allocated by this function, then copied from the input structure.
Prev: SE_CloneHierarchyOrderParameters.
Next: SE_CloneLODSelectParameters.
Up:Index.
|