SEDRIS Reference Manual
APPENDIX A - Transmittal Access Level 0 API
Functions
SE ResolveObject
extern SE_Return_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_RET_CODE_SUCCESS and the object is resolved.
SE_RET_CODE_FAILUREand the status code is set appropriately if the call failed.

Status Codes

SE_Status_Code(s) when SE_RET_CODE_SUCCESS is returned:

SE_STAT_CODE_SUCCESS set if a valid parameter was passed in and all operations succeeded.

SE_Status_Code(s) when SE_RET_CODE_FAILURE is returned:

SE_STAT_CODE_UNRESOLVED_OUTPUT_OBJECT set 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 set if object_in could not be resolved (i.e., the transmittal name portion of the reference could not be resolved).
SE_STAT_CODE_INACTIONABLE_FAILURE set if the call fails for any other reason.


Parameters Notes


object_in

 the SE_Object of the object reference to be resolved.


Prev: SE_RemoveFromTransmittal. Next: SE_ResolveTransmittalName. Up:Index.

Last updated: July 16, 2004 Copyright © 2004 SEDRIS