# kernelv_ch_get_filename()

## Prototyp

KERNELV_RETURN | kernelv_ch_get_filename (unsigned long int chanIndex, char *filename, unsigned short int nameLength, unsigned short int* returnLength);

## Beschreibung

Lesen des Dateinamens des aktuell im Kanal aktiven Programms.

## Parameter

Name | Typ | Bedeutung
chanIndex | unsigned long | Kanalindex des Kanals dessen Dateiname gelesen werden soll.
filename | char* | Zeiger auf den Speicherplatz für den Dateinamen.
nameLength | unsigned short | Länge des Speicherbereiches für den Dateinamen.
returnLength | unsigned short* | Zeiger auf den Wert, in den die tatsächlich zurückgegebene Anzahl Bytes geschrieben werden soll. Es wird die Anzahl der Zeichen des Dateinamens +1 zurückgegeben.

## Rückgabewerte

Symbol | Wert | Bedeutung
RET_FINISHED | 0 | Die Funktion wurde fehlerfrei durchgeführt.
ERR_INVALID_CHAN | -1 | Der übergebene Kanalindex ist größer als die Anzahl der konfigurierten Kanäle -1.
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 returnLength wird in diesem Fall der benötigte Speicher inklusive der terminierenden 0 zurückgegeben.