SEDRIS Reference Manual
APPENDIX B - LEVEL 1 READ and WRITE API
Functions
SE GetFeatureSameAsID
extern SE_Status_Code
SE_GetFeatureSameAsID
(
SE_Object object_in, (notes)
SE_ID *id_out_ptr (notes)
);

Definition

Given a <Feature Same As> object, retrieves the ID of the associated <Feature ID> object.


Returns

SE_STAT_CODE_SUCCESS and the ID field of the <Feature ID> is copied into *id_out_ptr, if valid parameters were passed in and all operations succeeded.
SE_STAT_CODE_NULL_REQUIRED_PARAMETER and no changes are made, if id_out_ptr is NULL.
SE_STAT_CODE_INVALID_OR_NULL_OBJECT and *id_out_ptr is set to zero (0), if object_in is not a handle to a valid, active (i.e., unfreed) <Feature Same As> instance.
SE_STAT_CODE_UNRESOLVED_START_OBJECT and *id_out_ptr is set to zero (0), if object_in is unresolved.
SE_STAT_CODE_NO_OBJECT and *id_out_ptr is set to zero (0), if object_in does not have an associated <Feature ID> instance.
SE_STAT_CODE_UNRESOLVED_OBJECT and *id_out_ptr is set to zero (0), if the <Feature ID> associate of object_in was unresolved, and could not be resolved.
SE_STAT_CODE_FAILURE and *id_out_ptr is set to zero (0), if the <Feature ID> associate of object_in is corrupt.
SE_STAT_CODE_OUT_OF_MEMORY and *id_out_ptr is set to zero (0), if memory allocation failed during an intermediate operation.


Parameters Notes


object_in

 <Feature Same As> that we're identifying.

id_out_ptr

 pointer to variable in the user's memory space where the
    result is placed.


Prev: SE_GetDataTableSubExtent. Next: SE_GetGeometrySameAsID. Up:Index.

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