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.