Function Name: Objects Are Same

Definition

Checks whether two SE_OBJECTs both refer to the same SEDRIS object.

Returns

SE_SUCCESS - and *result_out_ptr is set to the result of the check, if valid parameters were passed in and all operations succeeded.

SE_NULL_REQUIRED_PARAMETER - and *result_out_ptr is left unaltered, if result_out_ptr was NULL.

SE_INVALID_OR_NULL_OBJECT - and *result_out_ptr is set to SE_FALSE, if either object1_in or object2_in is not a handle referencing a valid SEDRIS object from an open transmittal.

SE_UNRESOLVED_OBJECT - and *result_out_ptr is set to SE_FALSE, if either object1_in or object2_in is not a currently resolved object (see SE_OBJECT's comments for details on how this condition occurs).

SE_FAILURE - and *result_out_ptr is set to SE_FALSE, 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_ObjectsAreSame
(
SE_OBJECT object1_in, (notes)
SE_OBJECT object2_in, (notes)
SE_BOOLEAN *result_out_ptr (notes)
);

Parameters Notes

object1_in

 the first SEDRIS object to be compared; must be resolved.

object2_in

 the second SEDRIS object to be compared; must be resolved.

result_out_ptr

 a pointer to an SE_BOOLEAN variable in the user's memory
    space where the answer will be stored.

Prev: Object Is Resolved. Next: Open Transmittal By File. Up:Index.