Function Name: Publish Object

Definition

Given a resolved SE_OBJECT, make the object available for ITR referencing by listing it as "published" within the transmittal. If the object has already been published, then the new label is added to the list of labels for the object.

Returns

SE_SUCCESS - if valid parameters were passed in and the object was successfully published.

SE_NULL_REQUIRED_PARAMETER - and object_in is left unaltered, if label_in is NULL.

SE_INVALID_OR_NULL_OBJECT - and object_in is left unaltered, if object_in is not a handle to a valid, active (not freed), resolved object.

SE_UNRESOLVED_OBJECT - and object_in is left unaltered, if object_in was not a resolved object.

SE_INVALID_OBJECT_LABEL - and object_in is left unaltered, if label_in does not adhere to the same lexical conventions as variables in ANSI C or is already in use.

SE_INVALID_ACCESS_MODE - and object_in is left unaltered, if object_in belongs to a transmittal opened in read-only mode.

SE_FAILURE - and object_in 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.

Prototype


extern SE_STATUS_CODE_ENUM
SE_PublishObject
(
SE_OBJECT object_in, (notes)
constchar *label_in (notes)
);

Parameters Notes

object_in

 the SE_OBJECT of the object to be published.

label_in

 a character string containing the label under which the object
    should be published.  The label must adhere to same lexical conventions
    as variables in ANSI C.

Prev: Print Volume LOD Entry. Next: Put Data Table. Up:Index.