re_SetErrorText_bas()

void KADMOS_API re_SetErrorText_bas(re_ErrorText_bas *errtext);

Parameter:

errtext
Pointer auf eine Datenstruktur vom Typ re_ErrorText_bas, in welcher der Fehlertext abgelegt sein muss (etwa durch einen Aufruf von re_GetErrorText_bas()). 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 errtext mit einem Aufruf von re_GetErrorText_bas() besetzt worden sein. re_SetErrorText_bas() 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_bas() der ursprüngliche (verursachende) Fehler zurückgegeben werden soll.

Verweise: