|
SEDRIS Reference Manual
APPENDIX A - LEVEL 0 READ and WRITE API Functions SE GetImplementationIdentifier |
|---|
| extern SE_Status_Code | |||
| SE_GetImplementationIdentifier | |||
| ( | |||
| SE_Object | object_in, | (notes) | |
| char | * | implementation_identifier_out_ptr | (notes) |
| ); | |||
Given a handle to an object, return the implementation identifier associated with the API implementation in which that object resides.
| SE_STAT_CODE_SUCCESS | and the implementation identifier associated with the object's API implementation is copied into *implementation_identifier_out_ptr, if valid parameters were passed in. |
| SE_STAT_CODE_NULL_REQUIRED_PARAMETER | and *implementation_identifier_out_ptr is left unaltered, if implementation_identifier_out_ptr is NULL. |
| SE_STAT_CODE_INVALID_OR_NULL_OBJECT | and *implementation_identifier_out_ptr is left unaltered, if object_in is not a handle to a valid, active (i.e., not freed) SEDRIS object. |
| SE_STAT_CODE_FAILURE | and *implementation_identifier_out_ptr is left unaltered, if the API implementation specified does not provide this function in its shared library, and dynamic binding is specified at compile time. |
the object for which the implementation identifier
should be returned.
a char* buffer from the user. The
implementation identifier will be copied into this buffer. The
user is responsible for allocating storage for this buffer before
calling this function.
See SE_MAX_IMPLEMENTATION_IDENTIFIER_SIZE for the limit on how
long an implementation identifier string can be.
Prev: SE_GetImageData.
Next: SE_GetIterationLengthRemaining.
Up:Index.
|