SEDRIS Reference Manual
APPENDIX A - Transmittal Access Level 0 API
Functions
SE GetObjectIDString
extern SE_Return_Code
SE_GetObjectIDString
(
SE_Object object_in, (notes)
SE_Store store_in, (notes)
constchar **id_string (notes)
);

Definition

Given an object, provides an id string managed by the store passed in which is 1) unique within the transmittal the object resides in and 2) the same over separate SE_Open and SE_Close sessions.


Returns

SE_RET_CODE_SUCCESS and the requested id string is returned.
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 valid parameters were 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 is unresolved.
SE_STAT_CODE_INACTIONABLE_FAILURE set if the call fails for any other reason.


Parameters Notes


object_in

 the object for which an id string is requested.

store_in

 the store that will manage the string memory

id_string

 pointer to the id string


Prev: SE_GetObjectFromIDString. Next: SE_GetObjectReferenceCount. Up:Index.

Last updated: July 16, 2004 Copyright © 2004 SEDRIS