|
SEDRIS Reference Manual
APPENDIX A - Transmittal Access Level 0 API Functions SE SetSecondErrorMessage |
|---|
| extern SE_Return_Code | ||||
| SE_SetSecondErrorMessage | ||||
| ( | ||||
| const | char | * | msg | (notes) |
| ); | ||||
If an error occurs for a situation where the user has registered an 'error-handling callback function', then that user-defined function is called, and is passed, among other items, two pointers to user-defined messages. The pointer for the second of those messages is set by this call. The pointer to the first message is set by the SE_SetFirstErrorMessage() function. These messages are left to the user to define and change as often as desired. The intent of these messages is to give the user the ability to construct an an intelligent error message that can give the user a good idea as to what was occurring within the user's code when the error occurred. The text of the message 'lives' entirely within the user's memory space. This API never attempts to copy the message and never accesses the message. The API simply stores the pointer and passes the pointer to the appropriate user-defined error-handling callback function at the appropriate times.
| SE_RET_CODE_SUCCESS | all operations succeeded. |
| SE_RET_CODE_FAILURE | and the status code is set appropriately if the call failed. |
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 upon failure. |
a pointer to the user-defined error message. If NULL,
'clears' the pointer.
Prev: SE_SetSRFInfo.
Next: SE_SetSpecificCallback.
Up:Index.
|