|
SEDRIS Reference Manual
APPENDIX C - LEVEL 0 READ and WRITE API AUXILIARY FUNCTIONS Functions SE CloneStateSelectParameters |
|---|
| extern SE_Status_Code | ||||
| SE_CloneStateSelectParameters | ||||
| ( | ||||
| const | SE_State_Select_Parameters | * | src_ptr, | (notes) |
| SE_State_Select_Parameters | * | dest_ptr | (notes) | |
| ); | ||||
Duplicates the data in a SE_State_Select_Parameters structure by allocating memory for its internal pointers (if any are in use), then populating it with data from the input SE_State_Select_Parameters structure. This function avoids the problems associated with doing a simple member-wise copy of the structure.
| SE_STAT_CODE_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_STAT_CODE_NULL_REQUIRED_PARAMETER | and no changes are made, if src_ptr or dest_ptr was NULL. |
| SE_STAT_CODE_OUT_OF_MEMORY | and *dest_ptr is initialized to empty, if memory allocation could not be performed. |
| SE_STAT_CODE_FAILURE | and *dest_ptr is initialized to empty, if *src_ptr is invalid. |
the SE_State_Select_Parameters that is to be duplicated
a pointer to an SE_State_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_CloneStateParameters.
Next: SE_CloneTimeSelectParameters.
Up:Index.
|