Given an SE_OBJECT, retrieve a handle to the transmittal in which the object is contained.
NOTE:
The user is responsible for calling
SE_FreeTransmittal() in order to release the memory associated with
*
transmittal_out_ptr when he or she is finished with it.
SE_NULL_REQUIRED_PARAMETER - and *transmittal_out_ptr is unaffected, if transmittal_out_ptr is NULL.
SE_INVALID_OR_NULL_OBJECT - and *transmittal_out_ptr is set to NULL, if object_in is not a handle to a valid, active (i.e., unfreed) SEDRIS object from an open transmittal.
SE_UNRESOLVED_START_OBJECT - and *transmittal_out_ptr is set to NULL, if object_in is unresolved.
SE_OUT_OF_MEMORY - and *transmittal_out_ptr is set to NULL, if *transmittal_out_ptr could not be allocated.
SE_FAILURE - and *transmittal_out_ptr is set to NULL, if the API implementation specified does not provide this function in its shared library, and dynamic binding is specified at compile time.
| extern SE_STATUS_CODE_ENUM | |||
| SE_GetTransmittalFromObject | |||
| ( | |||
| SE_OBJECT | object_in, | (notes) | |
| SE_TRANSMITTAL | * | transmittal_out_ptr | (notes) |
| ); | |||
the object for which the transmittal is being queried.
a pointer to an SE_TRANSMITTAL variable, provided
by the user. A handle to the transmittal containing the object
corresponding to id will be copied into *transmittal_out_ptr
by this function.