Definition

Given a <Geometry Model Instance>, retrieves the name of the <Model> that contains the <Geometry Model> being instanced.

Returns

SE_STAT_CODE_SUCCESS	and the output parameters are set appropriately, if valid parameters were passed in and all operations succeeded.
SE_STAT_CODE_NULL_REQUIRED_PARAMETER	and no changes were made, if result_out_ptr is NULL.
SE_STAT_CODE_INVALID_OR_NULL_OBJECT	and result_out_ptr is set to NULL, if object_in is not a handle to a valid, active (i.e., unfreed) <Geometry Model Instance>.
SE_STAT_CODE_INVALID_OR_NULL_STORE	and the output parameters are set as for SE_STAT_CODE_INVALID_OR_NULL_OBJECT, if store_in is not a handle to a valid, active (i.e., unfreed) SE_Store.
SE_STAT_CODE_UNRESOLVED_START_OBJECT	and the output parameters are set as for SE_STAT_CODE_INVALID_OR_NULL_OBJECT, if object_in is unresolved.
SE_STAT_CODE_NO_OBJECT	and the output parameters are set as for SE_STAT_CODE_INVALID_OR_NULL_OBJECT, if object_in isn't associated to a <Geometry Model> instance, or the <Geometry Model> isn't a component of a <Model> instance.
SE_STAT_CODE_UNRESOLVED_OBJECT	and the output parameters are set as for SE_STAT_CODE_INVALID_OR_NULL_OBJECT, if any unresolved intermediate object encountered that cannot be resolved.
SE_STAT_CODE_OUT_OF_MEMORY	and the output parameters are set as for SE_STAT_CODE_INVALID_OR_NULL_OBJECT, if memory cannot be allocated for an intermediate operation.
SE_STAT_CODE_FAILURE	and the output parameters are set as for SE_STAT_CODE_INVALID_OR_NULL_OBJECT, if the fields of the <Model> cannot be retrieved.

Parameters Notes

object_in

 <Geometry Model Instance> whose <Model> we're identifying

store_in

 store to manage the memory being retrieved

result_out_ptr

 pointer to a handle to the name being retrieved

Prev: SE_ModelNameFromFMI. Next: SE_PrintDesiredImageParameters. Up:Index.

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