SE GetLastFunctionStatus

SEDRIS Reference Manual APPENDIX A - Transmittal Access Level 0 API Functions SE GetLastFunctionStatus

extern SE_Return_Code
SE_GetLastFunctionStatus
(
	SE_Status_Code		*	last_fnct_sts,	(notes)
	SE_Store			store_in,	(notes)
const	char	*	*	error_descr	(notes)
);

Definition

This function provides a user of the SEDRIS API with additional status information for the last function called by that user prior to the invocation of this function; this information is in the form of an SE_Status_Code (last_fnct_sts) accompanied by an elaborating textual description (error_descr).

This additional status information is available only for the last function invoked. Upon the next call to the API, the internal status information returned by SE_GetLastFunctionStatus() will then be updated to refer to that function, regardless of its SE_Return_Code.

Returns

SE_RET_CODE_SUCCESS and the last function information is returned

SE_RET_CODE_FAILURE and 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 upon successful completion.

SE_Status_Code(s) when SE_RET_CODE_FAILURE is returned:

SE_STAT_CODE_INACTIONABLE_FAILURE set if the call fails for any reason.

Parameters Notes

last_fnct_sts

 an appropriate SE_Status_Code describing the last
 function (prior to the invocation of SE_GetLastFunctionStatus())
 invoked by the caller.

store_in

 manages the memory associated by this function with
 error_descr

error_descr

 elaborating information (in addition to last_fnct_sts)
 supplied regarding the last function (prior to the invocation of
 SE_GetLastFunctionStatus()) invoked by the caller.

SE_RET_CODE_SUCCESS	and the last function information is returned
SE_RET_CODE_FAILURE	and the status code is set appropriately if the call failed.