kernelv_ch_get_programname()

Prototyp

KERNELV_RETURN

kernelv_ch_get_programname (unsigned long int chanIndex,
                                                   char *programname,
                                                   unsigned short int nameLength,
                                                   unsigned short int* returnLength);

Beschreibung

Lesen des Dateinamens des aktuell im Kanal aktiven Programms. Der Programmname wird am Anfang des NC-Programms angegeben (siehe auch Programmieranleitung).

Parameter

Name	Typ	Bedeutung
chanIndex	unsigned long	Kanalindex des Kanals, dessen Programmname gelesen werden soll.
programname	char*	Zeiger auf den Speicherplatz für den Programmnamen.
nameLength	unsigned short	Länge des Speicherbereiches für den Programmnamen.
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 zurückgegeben.