# kernelv_get_error_message_values()

## Prototyp

KERNELV_RETURN | kernelv_get_error_message_string (KERNELV_ERROR_VALUE * p_values, unsigned long int *length);

## Beschreibung

Liefert die in einer Fehlermeldung ausgegebenen Werte zurück.

Vor Anwendung dieser Funktion muss durch Aufruf der Funktion kernelv_read_error() geprüft werden, ob ein Fehler vorliegt.

Die Werte werden in einem Array von Strukturen des Typs KERNELV_ERROR_VALUE zurückgegeben. Die Arraygröße beträgt KERNELV_ERROR_VALUE_COUNT. Im Aufrufparameter 'length' ist die Größe des Speicherbereiches für die Fehlermeldungswerte anzugeben.

Falls das zurückzugebende Array nicht in den bereitgestellten Speicher passt, wird der Rückgabewert ERR_CNC_RET_MEMORY ausgegeben und 'length' enthält die zur Rückgabe benötigte Speichergröße in Bytes.

## Parameter

Name | Typ | Bedeutung
p_values | KERNELV_ERROR_ VALUE* | Zeiger auf Zeichenkette für Fehlermeldungswerte. Der Speicher ist vom Aufrufer bereitzustellen.
length | unsigned long* | Größe des Speichers für die Fehlermeldungswerte. Wenn der bereitgestellte Speicher nicht ausreicht, wird die benötigte Speichergröße in Bytes zurückgegeben, andernfalls die Anzahl der zurückgelieferten Bytes.

## Rückgabewerte

Symbol | Wert | Bedeutung
RET_FINISHED | 0 | Die Funktion wurde fehlerfrei durchgeführt.
ERR_CNC_NOT_INIT | -3 | Der Simulations-CNC-Kern ist noch nicht initialisiert.
ERR_CNC_RET_MEMORY | -4 | Der oder die Rückgabewerte passen nicht in den bereitgestellten Speicher. Im Parameter 'length' wird die Anzahl der benötigten Bytes zurückgegeben.