SEDRIS Reference Manual
APPENDIX C - LEVEL 0 READ and WRITE API AUXILIARY FUNCTIONS
Functions
SE CloneSpatialIndexParameters
extern SE_Status_Code
SE_CloneSpatialIndexParameters
(
constSE_Spatial_Index_Parameters *src_ptr, (notes)
SE_Spatial_Index_Parameters *dest_ptr (notes)
);

Definition

Duplicates the data in a SE_Spatial_Index_Parameters structure by allocating memory for its internal pointers (if any are in use), then populating it with data from the input SE_Spatial_Index_Parameters structure. This function avoids the problems associated with doing a simple member-wise copy of the structure.


Returns

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.


Parameters Notes


src_ptr

 the SE_Spatial_Index_Parameters that is to be duplicated

dest_ptr

 a pointer to an SE_Spatial_Index_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_CloneQuadTreeSelectParameters. Next: SE_CloneStateEntry. Up:Index.

Last updated: May 15, 2003 Copyright © 2003 SEDRIS™