kernelv_get_error_values()
Prototyp
KERNELV_RETURN | GetErrorValues(out KERNELV_ERROR_VALUE[] values); |
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 |
values | out KERNELV_ERROR_VALUE[] | Array mit Fehlermeldungswerten. |
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. |