re_SetErrorText(), re_wSetErrorText()

extern void KADMOS_API re_SetErrorText(const re_ErrorText *errortext);

extern void KADMOS_API re_wSetErrorText(const re_wErrorText *errortext);

Parameter:

errortext: Pointer to a structure of the type re_ErrorText or re_wErrorText, in which the error text must be stored (e.g. by a call of re_GetErrorText() or re_wGetErrorText()). If the value is filled with NULL, the function works like re_ClearError().

Return value:

Comment:

Before calling this function, the content of the data structure re_ErrorText or re_wErrorText should be set by a call to re_GetErrorText() or re_wGetErrorText(). re_SetErrorText() and re_wSetErrorText() writes the given data back to KADMOS. This can be necessary especially when after the occurrence of a KADMOS error some terminating functions have to be called (which might internally call re_ClearError()), but the first (causing) KADMOS error shall be reported from calls to re_GetErrorText().