Function Name: Get Object For ID

Definition

Given an SE_OBJECT_ID, get the corresponding SEDRIS object.

Returns

SE_SUCCESS - if valid parameters were passed in and all operations succeeded.

SE_NULL_REQUIRED_PARAMETER - if object_out_ptr is NULL. In this case, *object_out_ptr is left unaltered.

SE_INVALID_OR_NULL_OBJECT - if id is not a handle to a valid, active (i.e., unfreed) object ID. In this case, *object_out_ptr is set to NULL.

SE_FAILURE - and *object_out_ptr is set to NULL, 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_GetObjectForID
(
SE_OBJECT_ID id, (notes)
SE_OBJECT *object_out_ptr (notes)
);

Parameters Notes

id

 the SE_OBJECT_ID.

object_out_ptr

 pointer to the SE_OBJECT corresponding to the
   SE_OBJECT_ID.
Prev: Get Number Of Paths To Transmittal Root. Next: Get Object Reference Count. Up:Index.