# kernelv_ax_set_position()

## Prototyp

KERNELV_RETURN | kernelv_ax_set_position (unsigned long int axisIndex, signed long int position);

## Beschreibung

Setzt die Istposition der Achse auf die im Parameter position angegebene Position. Diese Funktion kann nur dann ausgeführt werden, wenn in dem Kanal, zu dem die Achse aktuell gehört, kein NC-Programm aktiv ist. Wird bei aktivem NC-Programm versucht die Achsposition zu setzen, wird die Übernahme der Position verweigert und der Rückgabewert ERR_INVALID_STATE zurückgegeben.

## Parameter

Name | Typ | Bedeutung
axisIndex | unsigned long | Index der Achse.
position | unsigned long | Neue Istposition der Achse in 0,1 µm.

## Rückgabewerte

Symbol | Wert | Bedeutung
RET_FINISHED | 0 | Die Funktion wurde fehlerfrei durchgeführt.

RET_BUSY | 1 | Die Funktion wird gerade ausgeführt, ist aber noch nicht abgeschlossen. Die API-Funktion muss weiter aufgerufen werden.
ERR_CNC_NOT_INIT | -3 | Der Simulations-CNC Kern ist noch nicht initialisiert.
ERR_INVALID_STATE | -5 | Der CNC-Kanal der die Achse ist im falschen Zustand um eine Funktion auszuführen.
ERR_INVALID_AX | -9 | Die übergebene Achsindex ist größer als die Anzahl der konfigurierten Achsen – 1 oder Null.
ERR_INVALID_AX | -9 | Die übergebene Achsindex ist größer als die Anzahl der konfigurierten Achsen – 1.
ERR_AXIS_ERROR | -10 | Die CNC-Achse zeigt einen Fehler an. Es wird zusätzlich von der CNC eine Fehlermeldung ausgegeben.