Function Name: Resolve Object

Definition

Given an unresolved SE_OBJECT, attempt to resolve the reference and change the handle to a resolved state.

The name of the transmittal containing the object must first be resolved to a specific transmittal that can be accessed by the API. The object must then be resolved within the transmittal using object_in's published label.

Note that a SEDRIS transmittal that has been opened in this way cannot be written to or updated. The transmittal must be explicitly opened for writing or modification to do this.

Returns

SE_SUCCESS - if a valid, unresolved object was passed in and the object was successfully resolved.

SE_INVALID_OR_NULL_OBJECT - if object_in is not a handle to a valid, active (i.e., not freed) SEDRIS object. In this case, object_in is left unaltered.

SE_UNRESOLVED_OBJECT - if object passed in could not be resolved. This value indicates that the transmittal name was successfully resolved, but the transmittal did not contain the object label as a published object. In this case, object_in is left unaltered.

SE_UNRESOLVED_TRANSMITTAL - if object passed in could not be resolved. This value indicates that the transmittal name portion of the reference could not be resolved. In this case, object_in is left unaltered.

Prototype


extern SE_STATUS_CODE_ENUM
SE_ResolveObject
(
SE_OBJECT object_in (notes)
);

Parameters Notes

object_in

 the SE_OBJECT of the object reference to be resolved.

Prev: Remove From Transmittal. Next: Resolve Transmittal Name. Up:Index.