SE ResolveObject

SEDRIS Reference Manual APPENDIX A - LEVEL 0 READ and WRITE API Functions SE ResolveObject

extern SE_Status_Code
SE_ResolveObject
(
SE_Object	object_in	(notes)
);

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_STAT_CODE_SUCCESS and object_in becomes resolved, if a valid parameter was passed in and all operations succeeded.

SE_STAT_CODE_INVALID_OR_NULL_OBJECT and object_in is left unaltered, if object_in is not a handle to a valid, active (i.e., not freed) SEDRIS object.

SE_STAT_CODE_UNRESOLVED_OBJECT and object_in is left unaltered, if object_in could not be resolved (i.e., the transmittal name was successfully resolved, but the transmittal did not contain the object label as a published object).

SE_STAT_CODE_UNRESOLVED_TRANSMITTAL and object_in is left unaltered, if object_in could not be resolved (i.e., the transmittal name portion of the reference could not be resolved).

SE_STAT_CODE_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.

Parameters Notes

object_in

 the SE_Object of the object reference to be resolved.

SE_STAT_CODE_SUCCESS	and object_in becomes resolved, if a valid parameter was passed in and all operations succeeded.
SE_STAT_CODE_INVALID_OR_NULL_OBJECT	and object_in is left unaltered, if object_in is not a handle to a valid, active (i.e., not freed) SEDRIS object.
SE_STAT_CODE_UNRESOLVED_OBJECT	and object_in is left unaltered, if object_in could not be resolved (i.e., the transmittal name was successfully resolved, but the transmittal did not contain the object label as a published object).
SE_STAT_CODE_UNRESOLVED_TRANSMITTAL	and object_in is left unaltered, if object_in could not be resolved (i.e., the transmittal name portion of the reference could not be resolved).
SE_STAT_CODE_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.