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 auf eine Datenstruktur vom Typ re_ErrorText bzw. re_wErrorText, in welcher der Fehlertext abgelegt sein muss (etwa durch einen Aufruf von re_GetErrorText() bzw. re_wGetErrorText()). Wird der Wert mit NULL besetzt, so wirkt die Funktion wie re_ClearError().

Rückgabewert:

Bemerkung:

Vor dem Aufruf dieser Funktion sollte die durch ihre Adresse gegebene Datenstruktur re_ErrorText mit einem Aufruf von re_GetErrorText() bzw re_wGetErrorText() besetzt worden sein. re_SetErrorText() bzw. re_wSetErrorText() schreibt die gegebenen Werte wieder zurü ck. Dies ist insbesondere dann von Bedeutung, wenn nach Auftreten eines Fehlers noch abschliessende KADMOS-Funktionen aufgerufen werden müssen (welche intern re_ClearError() aufrufen), danach jedoch durch re_GetErrorText() oder re_wGetErrorText() der ursprüngliche (verursachende) Fehler zurückgegeben werden soll.