re_SetErrorText(), re_wSetErrorText()

extern void XXX_API re_SetErrorText
      (const re_ErrorText *errortext);

extern void XXX_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 XXX-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.