Function Name: Model ID From FMI

Definition

Given a Feature Model Instance, retrieves the ID of the Model that contains the Feature Model being instanced.

Returns

SE_SUCCESS - and the <Model>'s ID field is copied into *id_out_ptr, if valid parameters were passed in.

SE_NULL_REQUIRED_PARAMETER - and *id_out_ptr is left unaltered, if id_out_ptr is NULL.

SE_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 Model Instance>.

SE_UNRESOLVED_START_OBJECT - and *id_out_ptr is set to zero (0), if object_in is unresolved.

SE_NO_OBJECT - and *id_out_ptr is set to zero (0), if

  1. object_in's associated <Feature Model> cannot be found, or
  2. the associated <Feature Model>'s <Model> cannot be found.

SE_UNRESOLVED_OBJECT - and *id_out_ptr is set to zero (0), if

  1. object_in's associated <Feature Model> is unresolved and could not be resolved, or
  2. the associated <Feature Model>'s <Model> is unresolved and could not be resolved.

SE_OUT_OF_MEMORY - and *id_out_ptr is set to zero (0), if memory could not be allocated during an intermediate operation.

SE_FAILURE - and *id_out_ptr is set to zero (0), if the <Model>'s fields could not be retrieved.

Prototype


extern SE_STATUS_CODE_ENUM
SE_ModelIDFromFMI
(
SE_OBJECT object_in, (notes)
SE_ID *id_out_ptr (notes)
);

Parameters Notes

object_in

 <Feature Model Instance> whose <Model> we're identifying.

id_out_ptr

 pointer to variable in the user's memory space where the result is placed.
Prev: Image Name From Image Mapping Function. Next: Model ID From GMI. Up:Index.