Function Name: Add To Transmittal

Definition

Used to add an object to a SEDRIS transmittal.

NOTE: An object is in the unsaved state until it is added to a SEDRIS transmittal, whereupon it becomes resolved.

Returns

SE_SUCCESS - and new_object is added to transmittal, if valid parameters were passed in and all operations succeeded.

SE_INVALID_OR_NULL_OBJECT - and no changes are made, if new_object is not a handle to a valid, active (i.e., not freed) but *unsaved* object.

SE_INVALID_OR_NULL_TRANSMITTAL - and no changes are made, if transmittal isn't a handle to a valid, active (i.e., open and unfreed) transmittal.

SE_INVALID_ACCESS_MODE - and no changes are made, if transmittal was opened in read-only mode.

SE_FAILURE - and no changes are made, if the API implementation specified does not provide this function in its shared library, and dynamic binding is specified at compile time.

Prototype


extern SE_STATUS_CODE_ENUM
SE_AddToTransmittal
(
SE_OBJECT new_object, (notes)
SE_TRANSMITTAL transmittal (notes)
);

Parameters Notes

new_object

 the object to be added to the transmittal.

transmittal

 handle to the SEDRIS transmittal to which the new object
    is being added.
Prev: Add Symbolic Component. Next: Assign Reference Symbol To Object. Up:Index.